Execute Payout

Endpoint : POST https://api.zamplabs.com/api/v1/transfer/execute

This API will execute the payout

Request Body

Key	Value	Description	Optional
quote_id	test_vBug39YoTmvemwvddTnZi3_11_29	Quote id generated from rfq	N
reference_id	Reference of order id on merchant's system. This is accepted as a string value.	This helps us cross reference orders of merchant's systems associated with payout session	Y
purpose	string	Purpose of this Payout ("FAMILY", "INSURANCE", "INVESTMENT", "REAL_ESTATE", "TUITION", "MEDICAL", "TRAVEL", "TRADE_TRANSACTIONS", "UTILITY", "TAX", "LOAN", "BILLS", "PAYROLL", "TELECOM", "INTELLECTUAL_PROPERTY", "CHARITABLE_DONATIONS", "MORTGAGE", "EXPENSES_REIMBURSEMENT", "PERSONAL_ACCOUNT" (This is when the beneficiary is self), "PROFESSIONAL_SERVICES", "MARKETING", "RENTAL_PROPERTY")	N
documents	Array of string	Ids of the uploaded documents (Max 3 documents)	Y

Request JSON Representation

{
    "quote_id": "test_vBug39YoTmvemwvddTnZi3_11_29",
    "reference_id": "test_reference_id"
    "purpose": "INVESTMENT"
    "documents": ["123123_oic9NU2giTSN7Y6AJ8fUtR_11_13"]
}

Response Body

Key	Value	Description
id	test_rfAPE5VspwyVgD4zzfoEvk_12_02	This is the UUID with which merchant can uniquely identify a payout session on Zamp systems
message	Transaction Queued	Status of the payout session

Response JSON Representation

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

Error Codes

HTTP Code	Error Response	Description
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.