Payouts
Create Bank Withdrawal
API reference for creating withdrawal payouts to bank accounts
POST
/
payouts
/
banks
Copy
curl --request POST \
--url https://api-staging.stablestack.xyz/api/payouts/banks \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '{
"customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
"currency": "USDT",
"account_number": "1234567890",
"bank_name": "United Bank for Africa",
"bank_code": "000004",
"amount": "100",
"recipient_name": "John Doe",
"recipient_currency": "NGN",
"recipient_country": "Nigeria"
}'
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": null,
"transaction_type": "PAYOUT",
"transaction_mode": "DEBIT",
"exchange_rate": null,
"withdrawal_recipient_name": "John",
"fee": null,
"balance": "0.00000000",
"reason": "Withdraw to 1234567890/000004",
"customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
"recipient_currency": "NGN",
"recipient_country": "Nigeria",
"bank_name": "United Bank for Africa",
"bank_code": "000004",
"address": null,
"bank_account": "1234567890",
"amount_fiat": "0.00000000",
"fiat_reference_id": null
}
}
Creates a withdrawal payout to a bank account. Supports both customer and merchant withdrawals.
Key Features:
- Supports multiple currencies and banks
- Handles both customer and merchant payouts
- Includes recipient verification details
Request Body:
Bank Withdrawal:
Copy
{
"customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e", //optional
"currency": "USDT",
"account_number": "1234567890",
"bank_name": "United Bank for Africa",
"bank_code": "000004",
"amount": "100",
"recipient_name": "John Doe",
"recipient_currency": "NGN",
"recipient_country": "Nigeria"
}
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/banks \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '{
"customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
"currency": "USDT",
"account_number": "1234567890",
"bank_name": "United Bank for Africa",
"bank_code": "000004",
"amount": "100",
"recipient_name": "John Doe",
"recipient_currency": "NGN",
"recipient_country": "Nigeria"
}'
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": null,
"transaction_type": "PAYOUT",
"transaction_mode": "DEBIT",
"exchange_rate": null,
"withdrawal_recipient_name": "John",
"fee": null,
"balance": "0.00000000",
"reason": "Withdraw to 1234567890/000004",
"customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
"recipient_currency": "NGN",
"recipient_country": "Nigeria",
"bank_name": "United Bank for Africa",
"bank_code": "000004",
"address": null,
"bank_account": "1234567890",
"amount_fiat": "0.00000000",
"fiat_reference_id": null
}
}
Assistant
Responses are generated using AI and may contain mistakes.