Get required fields to create a beneficiary

Every country may have a different set of requirements to create a beneficiary to send funds. This API returns requirement dynamically based on the following input parameters.

Country
Banks
Customer type
Beneficiary type
Method

All possible fields for creating a beneficiary

Please note these fields maybe required based on the above criteria

Parameter Name	Description
`beneficiary_destination_account_number`	Account Number, 5–20 chars
`beneficiary_destination_branch_id`	Bank Branch Code
`beneficiary_bsb_number`	For AUS bank routing number
`beneficiary_transit_number`	For CAD bank routing number
`beneficiary_destination_method`	Allowed: BANK, E_WALLET
`transaction_purpose`
`beneficiary_country_code`	Alpha-3 Country Code, 3 chars
`beneficiary_first_name`	1–100 chars
`beneficiary_last_name`	1–100 chars
`beneficiary_nationality`
`transaction_purpose_remarks`
`beneficiary_type`	Allowed: INDIVIDUAL, BUSINESS
`beneficiary_residential_address`	Up to 255 chars
`beneficiary_phone`	Up to 20 chars (must include country code)
`beneficiary_state`	Usually 2 chars (US state code)
`beneficiary_town`
`beneficiary_city`	3–35 chars
`beneficiary_id_doc_type`	Doesn’t this have defined ENUMs?
`beneficiary_id_doc_type_remarks`
`beneficiary_occupation`
`beneficiary_occupation_remarks`
`beneficiary_id_doc_number`
`beneficiary_email`
`beneficiary_destination_currency`	3 chars (e.g., USD, PHP, etc.)
`beneficiary_bank_name`	1–100 chars
`beneficiary_branch_name`
`beneficiary_bic`	SWIFT/BIC
`beneficiary_id_doc_issue_date`	YYYY-MM-DD
`beneficiary_id_doc_expiry_date`	YYYY-MM-DD
`beneficiary_zip_code`
`beneficiary_iban`	IBAN format
`beneficiary_street`
`source_chain`	Allowed: POLYGON (or other chain)
`source_currency`	Allowed: USDC
`beneficiary_destination_rail`	Allowed: ACH, ACH_SAME_DAY, WIRE
`beneficiary_routing_number`	Exactly 9 chars
`beneficiary_postal_code`	5–9 chars
`customer_id`	36 chars
`developer_fee_fixed`	Min: 0
`developer_fee_percentage`	0–95
`refund_wallet_address`	Wallet address, 42 chars
`beneficiary_destination_method_id`	Min: 1

Guidelines on particular corridors

Please note all transfers are local transfers, hence local details are required and expected. There are a few cases where there may be a few guidelines on how to make the transfer. Those guidelines have been noted down below.

GBP transfers:

Use an IBAN starting with “GB” when entering a GBP account number. It must support Faster Payments Service (FPS).
Do not enter a local account number—this will cause the transfer to be cancelled.

INR transfers:

Must have a valid IFSC code. Address of the beneficiary must be within 35 characters.