Skip to main content

Execute Payout

Endpoint : POST https://api.zamp.finance/api/client/:clientid/customer/:customerid/internal/transfer/execute

This API will execute the payout

Request Body

KeyTypeDescriptionRequired
quote_idstringQuote id generated from rfqY
reference_idstringThis helps us cross reference orders of merchant's systems associated with payout sessionN
dest_account_idStringAccount Id to which funds will be creditedN
source_account_idStringAccount Id from which funds will be debitedN

Request JSON Representation

{
"quote_id": "o7o763_aLk2hdmLpDQctybwjw7E2g_07_24",
"dest_account_id": "o7o763_21Lb3eteAoW8BwhiJkMRkU_07_24",
"source_account_id": "o7o763_11Lb3eteAoW8BwhiJkMRkU_07_24",
"reference_id": "R123456789",
"comments": "dummy internal transfer request."
}

Response Body

KeyValueDescription
idtest_rfAPE5VspwyVgD4zzfoEvk_12_02This is the UUID with which merchant can uniquely identify a payout session on Zamp systems
messageTransaction QueuedStatus of the payout session

Response JSON Representation

{
"data": {
"id": "rfAPE5VspwyVgD4zzfoEvk_12_02",
"message": "Transaction Queued"
}
}

Error Codes

HTTP CodeError ResponseDescription
403{"code":"ACCESS_FORBIDDEN","message":"You are not authorized to access this record."}The Merchant is not allowed to access the requested resource (quote, corridor).
400{"code":"QUOTE_EXPIRED","message":"This quote is expired"}The requested quote has expired.
400{"code":"ALREADY_PROCESSED","message":"Transaction Already Processed"}The requested quote has already been processed.
400{"code":"AMOUNT_NOT_WITHIN_LIMITS","message":"Amount is not within limits."}The source or receiving amounts are not within acceptable limits.
400{"code":"INSUFFICIENT_BALANCE","message":"Balance is not sufficient for this transaction"}The source account balance is not sufficient for the requested transaction.