Status Inquiry - API Checkout
After you integrate successfully with Registration - API Checkout, your is ready to do s in real with your . However, recommend you to performs other Checkout API like this Inquiry .
This uses to check on you are requested on previous Registration - API Checkout such as successful or failed .
When is completed, you will automatically get from us. strongly recommend you to re-check using Status Inquiry - API Checkout.
API URL | /nicepay/direct/v2/inquiry |
Request Method | POST |
Header | Content-Type: application/json |
Merchant Token | SHA256 (timestamp+ iMid+ referenceNo+ amt+ merchantKey) |
When received to your dbProcessUrl, we strongly recommend to verify Notification using Status Inquiry - API Checkout.
![Status Inquiry - Notification Handling Status Inquiry - Notification Handling](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/W9M8IuHjqQ6IrGJiumu13_nicepay-api-checkout-api-notification-handling-flow-1.png?format=webp)
Parameter | Type | Size | Description | Remark |
timeStamp Required | N | 14 | 20221012080918 | |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST00202212191025073439 |
iMid Required | AN | 10 | IONPAYTEST | |
referenceNo Required | ANS | 40 | ORDER20221012080918 | |
amt Required | N | 12 | Transaction Amount | 10000 |
merchantToken Required | AN | 255 | d8d0968892c568bc6ff5adc17cd755f85334a0b58fce85392682993a9ba653ed |
Parameter | Type | Size | Description | Remark |
resultCd | N | 4 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | (empty) |
tXid | AN | 30 | Transaction ID | IONPAYTEST00202212191025073439 |
iMid | AN | 10 | IONPAYTEST | |
referenceNo | ANS | 40 | ORDER20221012080918 | |
payMethod | N | 2 | 00 | |
amt | N | 12 | 10000 | |
cancelAmt | N | 12 | Cancel Amount | null |
reqDt | N | 8 | Transaction Request Date (YYYYMMDD) | 20221219 |
reqTm | N | 6 | Transaction Request Time (HH24MISS) | 102507 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | null |
transTm | N | 6 | Transaction Time (HH24MISS) | null |
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 | |
billingNm | A | 100 | Buyer Name | John Doe |
status | N | 1 | null |
Parameter | Type | Size | Description | Remark |
authNo | N | 10 | Approval Number | |
issuBankCd | A | 4 | | |
acquBankCd | A | 4 | | |
acquBankNm | A | 255 | | |
issuBankNm | A | 255 | | |
cardNo | ANS | 20 | Card Number ith Masking | |
cardExpYymm | N | 4 | Card Expiration (YYMM) | |
instmntMon | N | 2 | | |
instmntType | N | 2 | | |
preauthToken | AN | 255 | | |
recurringToken | AN | 255 | | |
ccTransType | N | 2 | | |
acquStatus | N | 2 | Purchase Status 1: Normal 2: Recurring 3: Pre-auth 4: Capture | |
vat | N | 12 | | |
fee | N | 12 | Service Fee | |
notaxAmt | N | 12 | Tax-Fee Amount | |
Parameter | Type | Size | Description | Remark |
bankCd | A | 4 | | |
vacctNo | N | 16 | | |
vacctValidDt | N | 8 | VA Expiry date (YYYYMMDD) | |
vacctValidTm | N | 6 | VA Expiry time (HH24MISS) | |
Parameter | Type | Size | Description | Remark |
mitraCd | A | 4 | | |
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 | |