Skip to main content

Create a new bank account for a beneficiary

POST 
/api/v1/beneficiary/:beneficiaryId/bank-account

Creates a new bank account that belongs to a beneficiary by the beneficiary ID.

Validation rules by bank country:

USA:

  • accountNumber and ibanNumber are required.
  • At least one of swiftBic or achRoutingNumber must be provided.

Europe / Asia (all non-LATAM, non-USA countries):

  • accountNumber, ibanNumber and swiftBic are required.
  • achRoutingNumber is not applicable and will be ignored.

LATAM (Brazil, Argentina, Paraguay):

  • accountNumber is required.
  • ibanNumber, swiftBic and achRoutingNumber are not applicable and will be ignored.
  • bankCode is required for Brazil when bankName is provided.
  • taxId is required for Paraguay when bankName is provided.

Request​

Responses​

Bank account created successfully