Skip to main content

Create Fiat Beneficiary

For each receiver, you need to create a beneficiary on the platform. We will return a beneficiaryId, which can be used to make transfers.

We will run an AML and Sanctions check on them once added into the platform.

Endpoint : POST https://api.zamp.finance/api/client/:clientid/customer/:customerid/fiat/beneficiary

This API will create Fiat beneficiary

Request Body For AED Beneficiary

KeyValueDescriptionRequired
first_nameStringFirst Name of the beneficiary in String format (beneficiary_account_type is Individual)Yes
last_nameStringLast Name of the beneficiary in String format (beneficiary_account_type is Individual)Yes
account_typeIndividualType of the beneficiaryYes
destination_currencyStringDestination currency of the beneficiary in String format (USD,USDC)Yes
transfer_typeStringSWIFT,ACH,LOCALNo
beneficiary_bank_country_codeISO 3166 standard currency Code. (US)Country of the beneficiary bankNo
routing_code_type_1ACH CODE or SWIFTRouting code depending on the transfer typeNo
routing_code_value_1StringRouting value depending on the transfer type (ACH CODE/SWIFT)No
account_numberAlphaNumericBeneficiary IBAN to which payout needs to be madeYes
account_ownership_documentstringThe document proving ownership of the account in base64 encoding.No

Request JSON Representation of USD Beneficiary

{
"first_name": "john",
"last_name":"doe",
"account_type": "Individual",
"account_number": "8508697970656",
"transfer_type": "LOCAL",
"destination_currency": "AED",
"beneficiary_bank_country_code": "AE",
"beneficiary_alias": "Test",
"beneficiary_bank_name": "",
"account_ownership_document":"base64 of the document"

}

Response Body

KeyValueDescription
beneficiary_idmerchant_jXHm4aJH4vUmgcT6bmYGwD_11_30This is the UUID with which merchant can uniquely identify a beneficiary on Zamp systems

Response JSON Representation

{
"data": {
"beneficiary_id": "merchant_jXHm4aJH4vUmgcT6bmYGwD_11_30"
}
}