Status Inquiry - API Credit Card
Integrasi dengan API Status Inquiry pada Kartu Kredit diperlukan supaya Merchant dapat memeriksa status pada proses transaksi yang sedang berlangsung baik berstatus success, fail, dan lainnya.
Integrasi status inquiry pada Kartu Kredit bertujuan supaya Merchant dapat terhubung dengan sistem API untuk melakukan pemeriksaan status pada metode pembayaran Kartu Kredit.
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 menyarankan Merchant untuk melakukan verifikasi notifikasi tersebut dengan menggunakan Status Inquiry - API Credit Card.
Notification Handling sangat berguna untuk meminimalisir terjadinya Fraud. Kami sangat menganjurkan Merchant untuk memverifikasi Notification Handling. Anda dapat membaca informasi lebih rinci mengenai Notification Handling pada halaman Notification - API Credit Card.
Berikut ini adalah daftar parameter untuk melakukan request status inquiry pada proses transaksi Kartu Kredit:
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
timeStamp Required | N | 14 | Request Timestamp (YYYYMMDDHH24MISS) | 20221214091282 |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST01202212140949101366 |
iMid Required | AN | 10 | Merchant ID | IONPAYTEST |
referenceNo Required | ANS | 40 | Merchant Order No. | ordNo20221214091293 |
amt Required | N | 12 | Transaction Amount | 5000 |
merchantToken Required | AN | 255 | Merchant Token | 7eceb5801db4e039223698c4eb9... |
Berikut ini adalah daftar response dari pengajuan status inquiry pada proses transaksi Kartu Kredit.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 4 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | paid |
tXid | AN | 30 | Transaction ID | IONPAYTEST01202212140949101366 |
iMid | AN | 10 | Merchant ID | IONPAYTEST |
currency | A | 3 | Currency | IDR |
instmntMon | N | 2 | Installment Month | 1 |
instmntType | N | 2 | 1 | |
referenceNo | ANS | 40 | Merchant Ref. No. | ordNo20221214091293 |
payMethod | N | 2 | 01 | |
amt | N | 12 | Payment Amount | 5000 |
CancelAmt | N | 12 | Cancel Amount | null |
reqDt | N | 8 | Transaction Request Date (YYYYMMDD) | 20221214 |
reqTm | N | 6 | Transaction Request Time (HH24MISS) | 094910 |
status | N | 1 | 0 | |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221214 |
transTm | N | 6 | Transaction Time (HH24MISS) | 094910 |
depositDt | N | 8 | Transaction Deposit Date (YYYYMMDD) | null |
depositTm | N | 6 | Transaction Deposit Time (HH24MISS) | null |
currency | A | 3 | Currency | IDR |
goodsNm | AN | 100 | Goods Name | Goods |
billingNm | A | 100 | Buyer name | John Doe |
status | N | 1 | 0 |
Berikut ini adalah informasi daftar response tambahan dari request status inquiry pada proses transaksi Kartu Kredit.
Parameter | Tipe | Ukuran | Deskripsi | Catatan / Contoh |
authNo | N | 10 | Auth Number | 101366 |
issuBankCd | A | 4 | OTHR | |
acquBankCd | A | 4 | BMRI | |
acquBankNm | A | 255 | Acquiring Bank Name | Mandiri |
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 Payment Number | null |
mitraCd | A | 4 | null | |
receiptCode | ANS | 20 | Authorization No. | null |
cancelAmt | N | 12 | Cancel Amount | null |
payValidDt | N | 8 | CVS Expiry Date (YYYYMMDD) | null |
payValidTm | N | 6 | CVS Expiry Time (HH24MISS) | null |
mRefNo | AN | 20 | Bank Reference No. | |
issuBankNm | A | 100 | Issuing Bank Name | OTHER |
paymentExpDt | N | 6 | Payment Expiry Date (YYYYMMDD) | null |
paymentExpTm | N | 6 | Payment Expiry Time (HH24MISS) | null |
paymentTrxSn | AN | 32 | Payment Transaction Number | null |
userId | AN | 128 | QRIS User ID Hash | null |
shopId | AN | 32 | Shop ID | null |
cardNo | ANS | 20 | Masked Card Number | 453211*1111 |
cardExpYymm | N | 4 | Card Expiration (YYMM) | 2712 |
instmntMon | N | 2 | Installment Month | 1 |
instmntType | N | 2 | 1 | |
preauthToken | AN | 255 | Pre-Auth Token (Needed for Capture Payment) | null |
recurringToken | AN | 255 | Recurring Token (Needed for Recurring Payment) | null |
ccTransType | N | 2 | 1 | |
acquStatus | N | 2 | Purchase Status 1: Normal 2: Recurring 3: Pre-auth 4: Capture | 10 |
acquirerData | Array | 20 | A dynamic array consisting of a unique reference number RRN that is provided by the banking partner when a refund is processed. This reference number can be used by the customer to track the status of the refund with the bank. | "acquirerData": { "rrn": "332608321717" } |