Create Beneficiary Account


This endpoint allows a user to create a USD Beneficiary Account by submitting personal, address, and banking information. It supports both individual and business account types. The request must include valid bank routing information such as ABA code, IBAN, BIC, and the bank's address. A valid Bearer token is required for authentication, and the topic header must be set appropriately for event tracking.

Method API Endpoint
POST https://efylink-business.rare-able.com/api/user/beneficiary_accounts

headers: Object containing the API headers.

'Authorization : Bearer Token': Use Login API for access token

'X-CLIENT-ID': Use Get Credentials api to generate X-CLIENT-ID

'X-Api-Signature': To know how to generate please use Authentication

'X-Api-Timestamp': Timestamp

Body Params

type required Accepted values 1 - Individual, 2 - Business

name required Max - 50 Characters

currency required

country required ISO 2-letter code | Please use alpha_2_code from Lookups for Countries

primary_address required Max - 255 characters

secondary_address optional Optional | Max - 255 characters

city required Max - 50 characters

state optional Optional | Max - 50 characters

bank_country required ISO 2-letter code | Please use alpha_2_code from Lookups for Countries

postal_code required Max - 50 characters

iban required Max - 50 characters

account_number required Max - 50

bic required Max - 50

aba required Exactly 9 characters

bank_name required Max - 50

bank_city required Max - 50

bank_address required Max - 255

bank_postal_code required Max - 50