Create crypto transfer

curl --request POST \
  --url https://api.oyapasteaza.com/v1/disbursements/crypto \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": "10.50",
  "asset": "USDC",
  "network": "SOLANA",
  "destinationAddress": "7M9pXcRNsFj4UkQw8bY5dL6sT2aZ3gH1vPqEeKxQ2aBc"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: '10.50',
    asset: 'USDC',
    network: 'SOLANA',
    destinationAddress: '7M9pXcRNsFj4UkQw8bY5dL6sT2aZ3gH1vPqEeKxQ2aBc'
  })
};

fetch('https://api.oyapasteaza.com/v1/disbursements/crypto', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.oyapasteaza.com/v1/disbursements/crypto"

payload = {
    "amount": "10.50",
    "asset": "USDC",
    "network": "SOLANA",
    "destinationAddress": "7M9pXcRNsFj4UkQw8bY5dL6sT2aZ3gH1vPqEeKxQ2aBc"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "status": true,
  "message": "<string>",
  "data": {}
}

{
  "status": false,
  "message": "<string>",
  "code": "<string>"
}

POST

disbursements

crypto

Create crypto transfer

curl --request POST \
  --url https://api.oyapasteaza.com/v1/disbursements/crypto \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": "10.50",
  "asset": "USDC",
  "network": "SOLANA",
  "destinationAddress": "7M9pXcRNsFj4UkQw8bY5dL6sT2aZ3gH1vPqEeKxQ2aBc"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: '10.50',
    asset: 'USDC',
    network: 'SOLANA',
    destinationAddress: '7M9pXcRNsFj4UkQw8bY5dL6sT2aZ3gH1vPqEeKxQ2aBc'
  })
};

fetch('https://api.oyapasteaza.com/v1/disbursements/crypto', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.oyapasteaza.com/v1/disbursements/crypto"

payload = {
    "amount": "10.50",
    "asset": "USDC",
    "network": "SOLANA",
    "destinationAddress": "7M9pXcRNsFj4UkQw8bY5dL6sT2aZ3gH1vPqEeKxQ2aBc"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "status": true,
  "message": "<string>",
  "data": {}
}

{
  "status": false,
  "message": "<string>",
  "code": "<string>"
}

Send crypto from your available Pasteaza balance to a wallet on a supported network. Pasteaza validates the destination, calculates the applicable fee, and returns a transfer reference you can use to track the transaction.

Endpoint

POST /v1/disbursements/crypto

Headers

Authorization: Bearer sk_test_xxx
Content-Type: application/json
Idempotency-Key: crypto-transfer-ORDER-1042

Use a unique Idempotency-Key for each transfer. Reuse the same key only when retrying the same request.

Request body

Field	Type	Required	Description
`amount`	string	Yes	Amount of the selected asset to send, such as `10.50`.
`asset`	string	Yes	The asset to send. Currently supports `USDC` and `USDT`.
`network`	string	Yes	The destination network. Currently supports `SOLANA`.
`destinationAddress`	string	Yes	Recipient’s wallet address on the selected network.
`merchantReference`	string	No	Your unique reference for the transfer.
`metadata`	object	No	Additional data associated with the transfer.

Example request

curl https://api.oyapasteaza.com/v1/disbursements/crypto \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: crypto-transfer-ORDER-1042" \
  -d '{
    "amount": "10.5",
    "asset": "USDC",
    "network": "SOLANA",
    "destinationAddress": "7M9p...xQ2a",
    "merchantReference": "ORDER_1042",
    "metadata": {
      "customerId": "CUS_001"
    }
  }'

Successful response

{
  "status": true,
  "message": "Crypto transfer submitted.",
  "data": {
    "reference": "cw_91fe80aa755748d4bc58",
    "merchantReference": "ORDER_1042",
    "asset": "USDC",
    "network": "SOLANA",
    "amount": "10.5",
    "fee": "0.025",
    "totalDebit": "10.525",
    "destinationAddress": "7M9p...xQ2a",
    "status": "SUBMITTED",
    "transactionSignature": "5hY...m8Q",
    "failureReason": null,
    "metadata": {
      "customerId": "CUS_001"
    },
    "submittedAt": "2026-08-15T12:00:03.000Z",
    "confirmedAt": null,
    "failedAt": null,
    "createdAt": "2026-08-15T12:00:01.000Z"
  }
}

fee is the complete fee charged for the transfer. totalDebit is the total amount deducted from your balance.

Errors

Code	Meaning
`authentication_failed`	The API key is missing or invalid.
`validation_failed`	A required field or the `Idempotency-Key` header is missing or invalid.
`insufficient_balance`	Your available balance cannot cover the amount and fee.
`crypto_transfer_failed`	The transfer could not be submitted. The message explains what to correct.

Next step

Verify crypto transfer

Retrieve the latest transfer status.

Webhooks

Receive the final transfer result automatically.

Authorizations

Authorization

string

header

required

Use an sk_test_... key in the playground. Never enter a live key in shared environments.

Headers

Idempotency-Key

string

required

A unique key for safely retrying this request.

Example:

"2d3d82e4-70b8-4a1e-a78a-69415a601980"

Body

application/json

amount

string

required

Pattern: ^\d+(\.\d+)?$

Example:

"10.50"

asset

enum<string>

required

Available options:

USDC,

USDT

Example:

"USDC"

network

enum<string>

required

Available options:

SOLANA

Example:

"SOLANA"

destinationAddress

string

required

Example:

"7M9pXcRNsFj4UkQw8bY5dL6sT2aZ3gH1vPqEeKxQ2aBc"

merchantReference

string

Example:

"CRYPTO-PAYOUT-1001"

metadata

object

Example:

{ "orderId": "ORD-1042" }

Response

Crypto transfer created.

status

boolean

required

message

string

required

data

object

required

Getting Started

Collections

Disbursements

Create crypto transfer

Endpoint

Headers

Request body

Example request

Successful response

Errors

Next step

Verify crypto transfer

Webhooks

Authorizations

Headers

Body

Response

​Endpoint

​Headers

​Request body

​Example request

​Successful response

​Errors

​Next step

Verify crypto transfer

Webhooks

Authorizations

Headers

Body

Response

Endpoint

Headers

Request body

Example request

Successful response

Errors

Next step