Approve - API Payout (Disbursement)
Proses Approval bertujuan untuk meminta konfirmasi Anda terkait request pengiriman dana beserta rincian Bank penerima dana NICEPAY. API ini digunakan untuk menyetujui request yang diajukan pada 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 | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
timeStamp Required | N | 14 | API Request Date | 20221219085959 |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST07202212191238107952 |
iMid Required | AN | 10 | Merchant ID | IONPAYTEST |
merchantToken Required | AN | 255 | Merchant Token | 9f33948e1ce99b6f42c2a223234ec50ff1bc450c78a16885227c57fae4f4ff80 |
Apabila terjadi timeout pada saat proses Approve kepada NICEPAY, di harapkan untuk Merchant tidak menganggap status transaksi tersebut sukses atau gagal, melainkan suspect. Sebab, telah terjadi pemotongan dana pada status transaksi ini.
Transaksi yang dianggap suspect akan tetap terproses, hanya membutuhkan waktu tambahan. Setelah proses selesai, maka Merchant akan mendapatkan notifikasi status akhir transaksinya dari URL callback yang sudah daftarkan ke NICEPAY.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 4 | 0000 | |
resultMsg | AN | 10 | Result Message: Error Code | Success |
tXid | AN | 30 | Payout Transaction ID (Key from NICEPAY) | IONPAYTEST07202212191238107952 |
iMid | AN | 10 | Merchant ID | IONPAYTEST |
referenceNo | ANS | 40 | Merchant Order No.(Key from merchant) | ORD12345 |
amt | N | 12 | Payout Amount | 1000 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | null |
transTm | N | 6 | Transaction Time (HH24MISS) | null |
accountNo | N | 20 | Beneficiary Account No. | 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 | Generate Token by NICEPAY | 0030456405 |
mCode Only For Cashout | AN | 40 | Valid Token Time (HH24MISS) | NICEPAY CASHOUT TEST |