v1

latestOpenAPI 3.1.02026-07-2478315484.9 KB
Payouts

Create Payouts Destination(s)

Create payment destinations for use with Payouts. Destinations created with Payouts create a corresponding beneficiary with your bank.

post/payouts/v1/payment/destinations

Request body

bank_identifierstring

Uniquely identifies the bank of the benefeciary account

namestring required

The name of the legal entity associated with the account.

ibanstring required

The IBAN of the account

display_namestring

The friendly display name for the account.

account_numberstring

The account number for the account.

swift_codestring

The SWIFT Code for the bank account - required for most international destinations

ifscstring

The IFSC number for the bank account - required for international destinations in India.

sort_codestring

The Sort Code for the bank account - required for international destinations in the UK

routing_numberstring

The Routing Number for the bank account - required for international destinations in the US.

transit_codestring

The Transit Number for the bank account - required for international destinations in Canada

addressstring required

The address of the owner of the destination bank account has registered with the bank.

branch_addressstring

The address of the branch that holds the account - required for all beneficiaries outside of ARE. This should be a single string with commas separating lines.

countrystring required

The country that the holding financial institution is located in as a 3 letter ISO code.

citystring required

The city that the holding financial institution is located in.

customer_idstring

The associated Lean Customer

currency_iso_codestring required

The currency of the payee account

postal_codestring

The postal code of the bank branch that holds the account

Response

add_benefeciary_task_idstring uuid

The unique ID to track the destination creation request. This is useful for debugging

destination_idstring

The unique identifier for the Payment Destination object.

bank_identifierstring
ibanstring

IBAN of the destination account

account_numberstring

The account number for the account.

display_namestring

The friendly display name for the account.

status'CONFIRMED' | 'FAILED'

Specifies the status of the destination

error_messagestring

Error meesage received from the bank