Payouts
Create Wallet Withdrawal
API reference for creating withdrawal payouts to cryptocurrency wallets
POST
/
payouts
/
wallets
Copy
curl --request POST \
--url https://api-staging.stablestack.xyz/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": "bep20",
"recipient_name": "John Doe"
}'
Copy
{
"status": "success",
"data": {
"id": "f3394f78-682b-4d28-9cf6-53858fb8216f",
"sender_wallet_id": null,
"receiver_wallet_id": null,
"transaction_id": "EF40X2S02U",
"asset_code": "USDT",
"amount": "100.00000000",
"reference_id": "6b522909-45c9-406d-ac11-b645b79a0202",
"status": "PENDING",
"created_at": "2025-05-27T11:27:29.061Z",
"updated_at": "2025-05-27T11:27:29.061Z",
"crypto_transaction_id": null,
"network": "bep20",
"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
}
}
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:
Copy
{
"customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e", //optional
"currency": "USDC",
"address": "0x598C6d42fd6eE0ekleF4f9CAb789e264E8b895f3",
"amount": 0.1,
"network": "bep20",
"recipient_name": "John Doe"
}
Headers
Body
application/json
Response
200
application/json
Withdrawal created successfully
The response is of type object
.
Copy
curl --request POST \
--url https://api-staging.stablestack.xyz/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": "bep20",
"recipient_name": "John Doe"
}'
Copy
{
"status": "success",
"data": {
"id": "f3394f78-682b-4d28-9cf6-53858fb8216f",
"sender_wallet_id": null,
"receiver_wallet_id": null,
"transaction_id": "EF40X2S02U",
"asset_code": "USDT",
"amount": "100.00000000",
"reference_id": "6b522909-45c9-406d-ac11-b645b79a0202",
"status": "PENDING",
"created_at": "2025-05-27T11:27:29.061Z",
"updated_at": "2025-05-27T11:27:29.061Z",
"crypto_transaction_id": null,
"network": "bep20",
"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
}
}
Assistant
Responses are generated using AI and may contain mistakes.