Approve - API Payout (Disbursement)
The approval aims to request your confirmation related to request for a transfer of funds along with details of Beneficiary . This uses to confirm request from Registration - API Payout (Disbursement).
API Endpoint | /nicepay/api/direct/v2/approvePayout |
---|---|
Request Method | POST |
Header | Content-Type: application/json |
Merchant Token | SHA256 (timeStamp + iMid + tXid+ merchantKey) |
Parameter | Type | Size | Description | Example / Notes |
---|---|---|---|---|
timeStamp Required | N | 14 | Request Date | 20221219085959 |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST07202212191238107952 |
iMid Required | AN | 10 | ID | IONPAYTEST |
merchantToken Required | AN | 255 | Token | 9f33948e1ce99b6f42c2a223234ec50ff1bc450c78a16885227c57fae4f4ff80 |
If ever got a timeout during Approve to , hopefully doesn't treat as success or failed, but suspect. Because fund deduction already s on this .
Transactions that are considered suspect will still be ed, and only need extra time. After finishes, will get that final from registered callback URL to .
Parameter | Type | Size | Description | Example / Notes |
---|---|---|---|---|
resultCd | N | 4 | 0000 | |
resultMsg | AN | 10 | Result Message: Error Code | Success |
tXid | AN | 30 | Transaction ID (Key from ) | IONPAYTEST07202212191238107952 |
iMid | AN | 10 | ID | IONPAYTEST |
referenceNo | ANS | 40 | Order Number (Key from ) | ORD12345 |
amt | N | 12 | Amount | 1000 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | null |
transTm | N | 6 | Transaction Time (HH24MISS) | null |
accountNo | N | 20 | Beneficiary Account Number | 5345000060 |
benefNm | AN | 40 | Beneficiary Name | PT IONPAY NETWORKS |
bankCd | AN | 4 | BDIN | |
validDate Only For Cashout | N | 8 | Valid Token Date (YYYYMMDD) | 20220819 (Default D+1) |
validTm Only For Cashout | N | 6 | Valid Token Time (HH24MISS) | 131207 (Default D+1) |
cashoutToken Only For Cashout | N | 20 | Valid Token Time (HH24MISS) | 2070520843 |
mCode Only For Cashout | AN | 40 | Generate Token by | CASHOUT TEST |