Status Inquiry - API QRIS
Integrasi API Status Inquiry pada QRIS diperlukan supaya Merchant dapat memeriksa status yang berlangsung pada proses transaksi dengan status success, fail, dan lainnya. Sehingga sistem dapat memiliki laporan mengenai informasi tersebut.
Integrasi status Inquiry pada QRIS bertujuan bagi Merchant agar dapat terhubung dengan sistem API untuk melakukan pemeriksaan status pada metode pembayaran QRIS.
API End Point | /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 memberi saran kepada Merchant untuk melakukan verifikasi notifikasi tersebut dengan menggunakan Status Inquiry - API QRIS.
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 QRIS.
Berikut ini adalah daftar parameter untuk melakukan request status inquiry pada proses transaksi QRIS.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
timeStamp Required | N | 14 | Request Timestamp (YYYYMMDDHH24MISS) | 20221208091279 |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST08202212080918308275 |
iMid Required | AN | 10 | Merchant ID | IONPAYTEST |
referenceNo Required | ANS | 40 | Merchant Order No. | ORD54321 |
amt Required | N | 12 | Transaction Amount | 5 |
merchantToken Required | AN | 255 | Merchant Token | 52d30865f174e445cf731403b010ae099314edea9c399f7940fb2020d4045465 |
Berikut ini adalah daftar response dari request status inquiry pada proses transaksi QRIS.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 4 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | PAID |
tXid | AN | 30 | Transaction ID | IONPAYTEST08202212080918308275 |
iMid | AN | 10 | Merchant ID | IONPAYTEST |
referenceNo | ANS | 40 | Merchant Ref. No. | ORD54321 |
payMethod | N | 2 | 08 | |
amt | N | 12 | Payment Amount | 5 |
CancelAmt | N | 12 | Cancel Amount | null |
reqDt | N | 8 | Transaction Request Date (YYYYMMDD) | 20221208 |
reqTm | N | 6 | Transaction Request Time (HH24MISS) | 091830 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221208 |
transTm | N | 6 | Transction Time (HH24MISS) | 091830 |
depositDt | N | 8 | Transaction Deposit Date (YYYYMMDD) | Null |
depositTm | N | 6 | Transaction Deposit Time (HH24MISS) | |
mitraCd | A | 4 | QSHP | |
instmntMon | N | 2 | Installment Month | Null |
instmntType | N | 2 | 1 | |
cardNo | N | 20 | Credit Card Number | Null |
preauthToken | AN | 64 | Pre-Auth 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 | 20 | Virtual Account No. | Null |
bankCd | A | 4 | Null | |
payNo | N | 12 | CVS Number (CVS) | Null (For CVS) |
receiptCodeF | ANS | 20 | Authorization No. | Null (For Direct Debit) |
recurringToken | AN | 64 | Recurring Payment Token | Null (For CC) |
ccTransType | N | 2 | Null (For CC) | |
payValidDt | N | 8 | Expiry Date (YYYYMMDD) | Null |
payValidTm | N | 6 | Expiry Time (HH24MISS) | Null |
mRefNo | AN | 18 | Bank Reference No. | Null |
acquStatus | N | 2 | Purchase Status 1: Normal 2: Recurring 3: Pre-auth 4: Capture | Null (For CC) |
cardExpYymm | N | 4 | Card Expiration (YYMM) | Null (For CC) |
acquBankNm | A | 4 | Acquiring Bank Name | Null (For CC) |
issuBankNm | A | 255 | Issuing Bank Name | Null (For CC) |
depositDt | N | 8 | Deposit Date (YYYYMMDD) | Null (For VA) |
depositTm | N | 6 | Deposit Time (HH24MISS) | Null (For VA) |
paymentExpDt | N | 6 | QR Payment Expiry Date (YYYYMMDD) | 20221208 |
paymentExpTm | N | 6 | QR Payment Expiry Time (HH24MISS) | 092330 |
paymentTrxSn | N | 32 | Payment Transaction Number | 115045570008290314 |
cancelTrxSn | AN | 32 | Cancel Transaction Number | null |
currency | A | 3 | Currency | IDR |
goodsNm | AN | 100 | Goods Name | Test Transaction Nicepay |
billingNm | A | 100 | Buyer Name | Andi pamungkas |
status | N | 1 | 0 | |
userId | AN | 128 | QRIS User ID Hash | 115045570008290314 |
shopId | AN | 32 | Shop ID | NICEPAY |
Berikut ini adalah informasi daftar response tambahan dari request status inquiry pada proses transaksi QRIS.
Parameter | Tipe | Ukuran | Deskripsi |
mitraCd | A | 4 | Mitra Code |
cancelAmt | N | 12 | Cancel Amount |
paymentTrxSn | N | 32 | Payment Transaction Number |
paymentExpDt | N | 6 | QR Payment Expiry Date (YYYYMMDD) |
shopId | AN | 32 | Shop ID |
paymentExpTm | N | 6 | QR Payment Expiry Time (HH24MISS) |
cancelTrxSn | AN | 32 | Cancel Transaction Number |
userId | AN | 128 | QRIS User ID Hash |