Skip to main content
POST
/
payouts
/
wallets
curl --request POST \
  --url https://api-staging.stablestack.com/api/payouts/wallets \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
  "currency": "USDC",
  "address": "0x598C6d42fd6eE0ekleF4f9CAb789e264E8b895f3",
  "amount": 0.1,
  "network": "erc20",
  "recipient_name": "John Doe",
  "narration": "Payment for invoice #1042"
}
'
{
  "status": "success",
  "data": {
    "id": "f3394f78-682b-4d28-9cf6-53858fb8216f",
    "sender_wallet_id": null,
    "receiver_wallet_id": null,
    "transaction_id": "EF40X2S02U",
    "asset_code": "USDC",
    "amount": "100.00000000",
    "reference_id": "6b522909-45c9-406d-ac11-b645b79a0202",
    "status": "PROCESSING",
    "created_at": "2025-05-27T11:27:29.061Z",
    "updated_at": "2025-05-27T11:27:29.061Z",
    "crypto_transaction_id": null,
    "network": "erc20",
    "transaction_type": "PAYOUT",
    "transaction_mode": "DEBIT",
    "exchange_rate": null,
    "withdrawal_recipient_name": "John Doe",
    "fee": null,
    "balance": "0.00000000",
    "reason": "Withdraw to 0x598C6d42fd6eE0ekleF4f9CAb789e264E8b895f3",
    "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
    "recipient_currency": null,
    "recipient_country": null,
    "bank_name": null,
    "bank_code": null,
    "address": "0x598C6d42fd6eE0ekleF4f9CAb789e264E8b895f3",
    "bank_account": null,
    "amount_fiat": "0.00000000",
    "fiat_reference_id": null,
    "narration": "Payment for invoice #1042"
  }
}
Creates a withdrawal payout to a cryptocurrency wallet. Supports both customer and merchant withdrawals.

​
Key Features:

  • Supports multiple stablecoin and networks
  • Handles both customer and merchant payouts
  • Includes recipient verification details

​
Request Body:

Wallet Withdrawal: 
{
  "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e", //optional
  "currency": "USDC",
  "address": "0x598C6d42fd6eE0ekleF4f9CAb789e264E8b895f3",
  "amount": 0.1,
  "network": "erc20",
  "recipient_name": "John Doe"
}

Headers

​
x-api-key
string
required

Body

application/json
​
currency
enum<string>
required
Available options:
USDC
Example:

"USDC"

​
address
string
required
Example:

"0x598C6d42fd6eE0ekleF4f9CAb789e264E8b895f3"

​
amount
number
required
Example:

0.1

​
network
enum<string>
required
Available options:
erc20,
polygon
Example:

"erc20"

​
customer_id
string<uuid> | null

Required for customer withdrawals

Example:

"85b148ab-3f6b-4d55-917f-3c8de668a48e"

​
recipient_name
string | null
Example:

"John Doe"

​
narration
string | null

Optional note or reference for the transaction

Example:

"Payment for invoice #1042"

Response

Withdrawal created successfully

​
status
string
Example:

"success"

​
data
object