POST
/
payouts
/
banks
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"
}'
{
  "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:

{
  "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

x-api-key
string
required

Body

application/json

Response

200
application/json

Withdrawal created successfully

The response is of type object.