Skip to main content
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
​
currency
string
required
Example:

"USDT"

​
account_number
string
required
Example:

"1234567890"

​
bank_name
string
required
Example:

"United Bank for Africa"

​
bank_code
string
required
Example:

"000004"

​
amount
string
required
Example:

"100"

​
recipient_name
string
required
Example:

"John Doe"

​
recipient_currency
string
required
Example:

"NGN"

​
recipient_country
string
required
Example:

"Nigeria"

​
customer_id
string<uuid> | null

Required for customer withdrawals

Example:

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

Response

Withdrawal created successfully

​
status
string
Example:

"success"

​
data
object