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
Key | Value | Description | Required |
---|---|---|---|
first_name | String | First Name of the beneficiary in String format (beneficiary_account_type is Individual) | Yes |
last_name | String | Last Name of the beneficiary in String format (beneficiary_account_type is Individual) | Yes |
account_type | Individual | Type of the beneficiary | Yes |
destination_currency | String | Destination currency of the beneficiary in String format (USD,USDC) | Yes |
transfer_type | String | SWIFT,ACH,LOCAL | No |
beneficiary_bank_country_code | ISO 3166 standard currency Code. (US) | Country of the beneficiary bank | No |
routing_code_type_1 | ACH CODE or SWIFT | Routing code depending on the transfer type | No |
routing_code_value_1 | String | Routing value depending on the transfer type (ACH CODE/SWIFT) | No |
account_number | AlphaNumeric | Beneficiary IBAN to which payout needs to be made | Yes |
account_ownership_document | string | The 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
Key | Value | Description |
---|---|---|
beneficiary_id | merchant_jXHm4aJH4vUmgcT6bmYGwD_11_30 | This is the UUID with which merchant can uniquely identify a beneficiary on Zamp systems |
Response JSON Representation
{
"data": {
"beneficiary_id": "merchant_jXHm4aJH4vUmgcT6bmYGwD_11_30"
}
}