Integration of Status Inquiry on s is required so that s can check ongoing of carried out by whether is success, fail, and others. So that can have a report on that .
Integration Inquiry Status on aims so can connect to to perform checking on regularly.
API Endpoint | /nicepay/direct/v2/inquiry |
|---|---|
Request Method | POST |
Description | Performs Inquiry Request to for Status Checking |
Merchant Token | SHA256(timeStamp+iMid+referenceNo+amt+merchantKey) |
Request Format | application/json |
When your dbProcessUrl received a , strongly recommend to verify using Status Inquiry - API Virtual Account.
Notification Handling is very useful to minimize risk of Fraud. We strongly encourage s to verify Notification Handling using Notification - API Virtual Account SNAP.
The following is a list of s for requesting a inquiry in .
Parameter | Type | Size | Description | Example / Notes |
|---|---|---|---|---|
timeStamp Required | N | 14 | Request Timestamp (YYYYMMDDHH24MISS) | 20221215091222 |
tXid Required | AN | 30 | Transaction ID | NORMALTEST02202212150929011967 |
iMid Required | AN | 10 | ID | NORMALTEST |
referenceNo Required | ANS | 40 | Order Number | ordNo20221215091214 |
amt Required | N | 12 | Transaction Amount | 1000 |
merchantToken Required | AN | 255 | Token | ea6e691a895f1ccc0602f534205ee60bc552552dde7610062cd048ea6c87965e |
The following is a list of responses to requests for inquiry on es.
Parameter | Type | Size | Description | Example / Notes |
|---|---|---|---|---|
resultCd | N | 4 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | paid |
tXid | AN | 30 | Transaction ID | NORMALTEST02202212150929011967 |
iMid | AN | 10 | ID | NORMALTEST |
referenceNo | ANS | 40 | Reference Number | ordNo20221215091214 |
payMethod | N | 2 | 02 | |
amt | N | 12 | Amount | 10000 |
CancelAmt | N | 12 | Cancel amount | null |
reqDt | N | 8 | Transaction Request Date (YYYYMMDD) | 20221215 |
reqTm | N | 6 | Transaction Request Time (HH24MISS) | 092901 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221215 |
transTm | N | 6 | Transction Time (HH24MISS) | 092901 |
depositDt | N | 8 | Transaction Deposit Date (YYYYMMDD) | null |
depositTm | N | 6 | Transaction Deposit Time (HH24MISS) | null |
mitraCd | A | 4 | ALMA | |
instmntMon | N | 2 | Installment Month | null |
instmntType | N | 2 | 1 | |
cardNo | N | 20 | Number | null |
preauthToken | AN | 64 | Pre-Auth Token | null |
acquBankCd | A | 4 | null | |
issuBankCd | A | 4 | null | |
vacctValidDt | N | 8 | VA Expiry Date (YYYYMMDD) | 20221231 |
vacctValidTm | N | 6 | VA Expiry Time (HH24MISS) | 235959 |
vacctNo | N | 20 | Number | 9912304000001487 |
bankCd | A | 4 | CENA | |
payNo | N | 12 | CVS number (CVS) | null |
mitraCd | A | 4 | null | |
receiptCode | ANS | 20 | Authorization Number | null |
recurringToken | AN | 64 | Recurring Token | null |
ccTransType | N | 2 | null | |
payValidDt | N | 8 | Expiry Date (YYYYMMDD) | null |
payValidTm | N | 6 | Expiry Time (HH24MISS) | null |
mRefNo | AN | 18 | Reference Number | null |
acquStatus | N | 2 | Purchase Status 1: Normal 2: Recurring 3: Pre-Auth 4: Capture | null |
cardExpYymm | N | 4 | Card Expiration (YYMM) | null |
acquBankNm | A | 255 | Acquiring Name | null |
issuBankNm | A | 255 | Issuing Name | null |
depositDt | N | 8 | Deposit Date (YYYYMMDD) | 20221215 |
depositTm | N | 6 | Deposit Time (HH24MISS) | 092936 |
paymentExpDt | N | 6 | QR Expiry Date (YYYYMMDD) | null |
paymentExpTm | N | 6 | QR Expiry Time (HH24MISS) | null |
paymentTrxSn | N | 32 | Transaction Number | null |
cancelAmt | N | 12 | Cancel Amount | null |
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 | John Doe |
status | N | 1 | 0 | |
userId | AN | 128 | User ID Hash | null |
shopId | AN | 32 | Shop ID | null |
The following is a list of additional responses from inquiry request in .
Parameter | Type | Size | Descriprion |
|---|---|---|---|
bankCd | A | 4 | |
vacctNo | N | 16 | Number |
vacctValidDt | N | 8 | VA Expiry Date (YYYYMMDD) |
vacctValidTm | N | 9 | VA Expiry Time (HH24MISS) |
By accessing this site, you are agree with the applicable terms and conditions.
Bank Indonesia already release API Standard relate to the Payment listed on Peraturan Anggota Dewan Gubernur No 23/15/PADG/2021 about Standar Nasional Open Application Interface Pembayaran (SNAP) Implementation.
As the form of suppport and compliance to Bank Indonesia Rules, NICEPAY drives all Merchant to conduct the migration to API SNAP BI.
All Merchants aim to complete the API SNAP BI migration on June 2024.