What to Collect from Users | Description | Request Field | Example |
---|
Recipient's Full Name | The full name of the bank account holder, must match bank records | account_holder_name | Simon Smith |
Account Number | The recipient's bank account number (typically 8-12 digits, without spaces or special characters) | account_number | 06137128 |
ABA Routing Number Type | International standard code identifying the routing number type (common types: sort code for UK, ABA for US) | routing_type | aba |
Bank Branch Identifier | Specific branch number of the recipient's bank (format varies by country, e.g. 6-digit sort code for UK) | routing_number | 00290019 |
Recipient Bank Country | Use ISO 3166-1 two-letter country codes | country | Example for USA: US |
Supported Payout Methods:#
Payout Method | Supported Currency |
---|
Bank account | USD |
Request Example#
The following example contains the minimum parameter range. For parameter descriptions, refer to: [Create a Payout]{
"payment_currency": "USD",
"payment_amount": 5500,
"source_currency": "USD",
"beneficiary_data": {
"destination_data": {
"destination_type": "bank_account",
"bank_account": {
"account_number": "06137128",
"routing_type": "aba",
"routing_number": "00290019",
"account_holder_name": "JEROME VERGHESE ONIL",
"country": "US"
}
}
},
"merchant_payout_id": "pay_123123123"
}
Retrieve a Payout#
Webhook#
POST:/v1/webhook_endpoints{
"url": "https://...",
"description": "I am description",
"enabled_events": [
"payout.canceled",
"payout.created",
"payout.failed",
"payout.paid",
"payout.updated"
]
}
Once a webhook is successfully registered, an HTTPS request will be automatically sent to the registered URL whenever any of the specified events occur.
Test Webhook#
Create a payout to trigger thepayout.created
event. This will send a callback notification about the payout creation event to your designated Webhook URL.Modified at 2025-08-08 04:01:47