Status Inquiry - API Credit Card
Integration with the Status Inquiry API on credit cards is required so that Merchants can check the status of ongoing transaction processes, whether they are successful, failed, and other status.
The integration of status inquiries on Credit Cards aims to enable merchants to connect with the API system which has function to checking the status of credit card payment methods.
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 |
When your dbProcessUrl received a notification, NICEPAY strongly recommend Merchant to verify the notification using the Status Inquiry - API Credit Card.
Notification Handling is very useful to minimize the risk of Fraud. We strongly encourage Merchants to verify Notification Handling. You can read more detailed information about Notification Handling on Notification - API Credit Card page.
The following is a list of request parameters to proceed the status Inquiry request on Credit Card transaction process:
Parameter | Type | Size | Description | Example / Notes |
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... |
The following is a list of Response Parameter or the result from the Request Parameter for Status Inquiry Credit Card.
Parameter | Type | Size | Description | Example / Notes |
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 | Transaction Status | 0 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221214 |
transTm | N | 6 | Transction 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 |
Here is a list of additional response parameter for the result from the request status inquiry for Credit Card process.
Parameter | Type | Size | Description | Example / Notes |
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 | null |
issuBankNm | A | 255 | 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" } |