> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oyapasteaza.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Verify temporary crypto wallet

> Retrieve the payment status of a temporary crypto wallet.

Retrieve a temporary wallet using either its Pasteaza `reference` or your `merchantReference`.

## Endpoint

```http theme={null}
GET /v1/crypto/temporary-addresses/{reference}/status
```

## Headers

```http theme={null}
Authorization: Bearer sk_test_xxx
```

## Path parameters

| Field | Type | Required | Description |
| - | - | - | - |
| `reference` | string | Yes | The Pasteaza `cp_...` reference or your `merchantReference`. |

## Example request

```bash theme={null}
curl https://api.oyapasteaza.com/v1/crypto/temporary-addresses/ORDER_1042/status \
  -H "Authorization: Bearer sk_test_xxx"
```

## Successful response

```json theme={null}
{
  "status": true,
  "message": "Temporary crypto wallet retrieved.",
  "data": {
    "reference": "cp_MXxqjm8zS3LwQdKp",
    "merchantReference": "ORDER_1042",
    "asset": "USDC",
    "network": "SOLANA",
    "amount": "25.5",
    "receivedAmount": "25.5",
    "creditedAmount": "25.3725",
    "collectionFee": "0.1275",
    "address": "7M9p...xQ2a",
    "status": "PAID",
    "expiresAt": "2026-08-15T10:30:00.000Z",
    "paidAt": "2026-08-15T10:08:40.000Z",
    "metadata": {
      "customerId": "CUS_001"
    },
    "payments": [
      {
        "transactionSignature": "5hY...m8Q",
        "amount": "25.5",
        "status": "CONFIRMED",
        "detectedAt": "2026-08-15T10:08:21.000Z",
        "confirmedAt": "2026-08-15T10:08:40.000Z"
      }
    ],
    "createdAt": "2026-08-15T10:00:00.000Z"
  }
}
```

## Status values

| Status | Meaning |
| - | - |
| `PENDING` | Pasteaza is waiting for the exact payment. |
| `DETECTED` | A matching blockchain transaction was detected. |
| `CONFIRMING` | The transaction is waiting for the required network confirmation. |
| `PAID` | The exact payment was confirmed and credited. |
| `EXPIRED` | The payment window ended before a valid exact payment was confirmed. |
| `CANCELLED` | The collection was cancelled because wallet allocation failed. |
| `REVIEW_REQUIRED` | A payment needs manual investigation. |

## Errors

| Code | Meaning |
| - | - |
| `authentication_failed` | The API key is missing or invalid. |
| `validation_failed` | `reference` is missing. |
| `crypto_temporary_wallet_not_found` | No wallet matched the reference in this merchant and environment. |

<Card title="Webhooks" icon="webhook" href="/getting-started/webhooks">
  Use webhooks instead of polling continuously when possible.
</Card>


## OpenAPI

````yaml openapi.yaml GET /v1/crypto/temporary-addresses/{reference}/status
openapi: 3.1.0
info:
  title: Pasteaza API
  version: 1.0.0
  description: Collect and disburse bank and crypto payments with Pasteaza.
servers:
  - url: https://api.oyapasteaza.com
    description: Pasteaza API — the API key selects test or live mode
security:
  - bearerAuth: []
tags:
  - name: Hosted Checkout
  - name: Virtual Accounts
  - name: Dedicated Bank Accounts
  - name: Temporary Crypto Wallets
  - name: Dedicated Crypto Wallets
  - name: Bank Transfers
  - name: Crypto Transfers
paths:
  /v1/crypto/temporary-addresses/{reference}/status:
    get:
      tags:
        - Temporary Crypto Wallets
      summary: Verify temporary crypto wallet
      operationId: getTemporaryCryptoWalletStatus
      parameters:
        - $ref: '#/components/parameters/Reference'
      responses:
        '200':
          description: Temporary wallet status retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
        default:
          $ref: '#/components/responses/Error'
components:
  parameters:
    Reference:
      name: reference
      in: path
      required: true
      description: Pasteaza reference or supported merchant reference.
      schema:
        type: string
  schemas:
    SuccessResponse:
      type: object
      required:
        - status
        - message
        - data
      properties:
        status:
          type: boolean
          const: true
        message:
          type: string
        data:
          type: object
          additionalProperties: true
    ErrorResponse:
      type: object
      required:
        - status
        - message
        - code
      properties:
        status:
          type: boolean
          const: false
        message:
          type: string
        code:
          type: string
  responses:
    Error:
      description: Request failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Pasteaza secret key
      description: >-
        Use an `sk_test_...` key in the playground. Never enter a live key in
        shared environments.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.