Status Inquiry - API E-Wallet
Integrasi API Status Inquiry pada E-Wallet diperlukan supaya Merchant dapat memeriksa status yang berlangsung pada proses transaksi yang dilakukan oleh Pelanggan baik status success, fail, dan lainnya. Sehingga sistem dapat memiliki laporan mengenai informasi tersebut.
Integrasi status inquiry pada E-Wallet memiliki tujuan supaya Merchant dapat terhubung dengan sistem API untuk melakukan pemeriksaan status pada metode pembayaran E-Wallet secara berkala.
API Endpoint | /nicepay/direct/v2/inquiry |
Request Method | POST |
Description | Performs Inquiry Request to NICEPAY for Status Checking |
Merchant Token | SHA256(timeStamp+iMid+referenceNo+amt+merchantKey) |
Request Format | application/json |
Ketika notifikasi diterima dbProcessUrl Anda, kami sangat menganjurkan Merchant untuk melakukan verifikasi Notifikasi tersebut dengan menggunakan Status Inquiry - API E-Wallet.
Notification Handling sangat berguna untuk meminimalisir terjadinya Fraud. Kami sangat menganjurkan Merchant untuk melakukan verifikasi Notification Handling. Anda dapat membaca informasi lebih rinci mengenai Notification Handling pada Notification - API E-Wallet.
Berikut ini adalah daftar parameter untuk melakukan request status inquiry pada proses transaksi E-Wallet.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
timeStamp Required | N | 14 | Request Timestamp (YYYYMMDDHH24MISS) | 20221208065959 |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST05202212081111197444 |
iMid Required | AN | 10 | Merchant ID | IONPAYTEST |
referenceNo Required | ANS | 40 | Merchant Order No. | ORD20221208 |
amt Required | N | 12 | Transaction Amount | 2000 |
merchantToken Required | AN | 255 | Merchant Token | 324a7d07d9f3fe30a3960b28af29a91fc30a33fb3332cf33d40394f30d1f399f |
Berikut ini adalah daftar response dari request status inquiry pada proses transaksi E-Wallet.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 4 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | paid |
tXid | AN | 30 | Transaction ID | IONPAYTEST05202212081111197444 |
iMid | AN | 10 | Merchant ID | IONPAYTEST |
currency | A | 3 | Currency | IDR |
referenceNo | ANS | 40 | Merchant Ref. No. | ORD20221208 |
payMethod | N | 2 | 05 | |
amt | N | 12 | Payment Amount | 2000 |
CancelAmt | N | 12 | Cancel Amount | |
reqDt | N | 8 | Transaction Request Date (YYYYMMDD) | 20221208 |
reqTm | N | 6 | Transaction Request Time (HH24MISS) | 111119 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221208 |
transTm | N | 6 | Transaction Time (HH24MISS) | 111234 |
instmntMon | N | 2 | Installment Month | null |
instmntType | N | 2 | 1 | |
cardNo | ANS | 20 | Masker Card No. | null |
preauthToken | AN | 64 | Pre-Auth Payment Token | null |
acquBankCd | A | 4 | null | |
issuBankCd | A | 4 | null | |
vacctValidDt | N | 8 | VA Expiry Date (YYYYMMDD) | null |
vacctValidTm | N | 6 | VA Expiry Time (HH24MISS) | null |
vacctNo | N | 16 | Bank Virtual Account Number | null |
bankCd | A | 4 | null | |
payNo | N | 12 | Payment Number | null |
mitraCd | A | 4 | DANA | |
receiptCode | ANS | 20 | Authorization Number | null |
recurringToken | AN | 64 | Reccurring Token | null |
ccTransType | N | 2 | null | |
payValidDt | N | 8 | CVS Expiry Date (YYYYMMDD) (CVS) | null |
payValidTm | N | 6 | CVS Expiry Time (HH24MISS) (CVS) | null |
mRefNo | AN | 20 | Bank Reference No. (Direct Debit) | null |
acquStatus | N | 2 | Purchase Status 1 : Normal 2 : Recurring 3 : Pre-auth 4 : Capture | null |
cardExpYymm | N | 4 | Card Expiry (YYMM) | null |
acquBankNm | A | 255 | Acquiring Bank Name | null |
issuBankNm | A | 255 | Issuing Bank Name | null |
depositDt | N | 8 | Transaction Deposit Date (YYYYMMDD) | null |
depositTm | N | 6 | Transaction Deposit Time (HH24MISS) | null |
userId | AN | 128 | QRIS User ID Hash | null |
shopId | AN | 32 | Shop ID | null |
currency | A | 3 | Currency | null |
goodsNm | AN | 100 | Goods Name | Test Transaction Nicepay - Riko Adi Setiawan |
billingNm | A | 100 | Buyer Name | Riko Adi SetiawaN |
status | N | 1 | 0 |
Berikut ini adalah informasi daftar response tambahan dari request status inquiry pada proses transaksi lainnya.
Parameter | Tipe | Ukuran | Deskripsi |
mitraCd | A | 4 | (CVS, Direct Debit, E-Wallet, Payloan) |
payNo | N | 12 | CVS Number (CVS) |
payValidDt | N | 8 | CVS Expiry Date (YYYYMMDD) (CVS) |
payValidTm | N | 6 | CVS Expiry Time (HH24MISS) (CVS) |
receiptCode | ANS | 20 | Authorization Code (CVS) |
mRefNo | AN | 20 | Bank Reference No. (Direct Debit) |