Beneficiary
Add Bank Account
API reference for adding bank payout methods
POST
/
payout
/
methods
/
banks
Copy
curl --request POST \
--url https://api-staging.stablestack.xyz/api/payout/methods/banks \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '{
"type": "BANK",
"customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
"account_name": "John Doe",
"account_number": "1234567890",
"bank_name": "Test Bank",
"currency": "NGN",
"bank_code": "000006",
"sort_code": "202524",
"swift_code": "",
"routing_number": "",
"iban": ""
}'
Copy
{
"status": "success",
"data": {
"id": "a1b2c3d4-e67f-42a2-b24a-d33f220a0d37",
"type": "BANK",
"currency": "NGN",
"account_name": "John Doe",
"account_number": "1234567890",
"bank_name": "Test Bank",
"bank_code": "000006",
"sort_code": null,
"swift_code": null,
"routing_number": null,
"iban": null,
"created_at": "2025-05-12T15:30:56.623Z",
"updated_at": "2025-05-12T15:30:56.623Z",
"customer_id": null
},
"message": "Merchant payout method added successfully!"
}
Adds a new bank payout method (either merchant-owned or customer-specific).
- Include
customer_id
to create for a specific customer - Omit
customer_id
to create merchant-owned bank account
Request Body:
Copy
{
"customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e", // optional
"account_name": "John Doe",
"account_number": "1234567890",
"bank_name": "Test Bank",
"currency": "NGN",
"bank_code": "000006",
"sort_code": "202524", // For GBP
"swift_code": "", // For international transfers
"routing_number": "", // For USD
"iban": "" // For international accounts
}
Headers
Body
application/json
Response
201
application/json
Bank account added successfully
The response is of type object
.
Copy
curl --request POST \
--url https://api-staging.stablestack.xyz/api/payout/methods/banks \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '{
"type": "BANK",
"customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
"account_name": "John Doe",
"account_number": "1234567890",
"bank_name": "Test Bank",
"currency": "NGN",
"bank_code": "000006",
"sort_code": "202524",
"swift_code": "",
"routing_number": "",
"iban": ""
}'
Copy
{
"status": "success",
"data": {
"id": "a1b2c3d4-e67f-42a2-b24a-d33f220a0d37",
"type": "BANK",
"currency": "NGN",
"account_name": "John Doe",
"account_number": "1234567890",
"bank_name": "Test Bank",
"bank_code": "000006",
"sort_code": null,
"swift_code": null,
"routing_number": null,
"iban": null,
"created_at": "2025-05-12T15:30:56.623Z",
"updated_at": "2025-05-12T15:30:56.623Z",
"customer_id": null
},
"message": "Merchant payout method added successfully!"
}
Assistant
Responses are generated using AI and may contain mistakes.