Status Inquiry - API Payloan
Integration of the Status Inquiry API in Payloan is required so that Merchants can check the ongoing status of the transaction process carried out by the Customer whether the status is success, fail, and others. So, the system can have a report on that information.
Integration of Inquiry status on the Payloan aims to enable merchants to connect with the API system to check the status of Payloan payment methods regularly.
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 |
When your dbProcessUrl received a notification, NICEPAY strongly encourage Merchants to verify the notification using the Status Inquiry - API Payloan
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 Payloan page.
The following is a list of responses to request status inquiries on Payloan transaction processes.
Parameter | Type | Size | Description | Example / Notes |
timeStamp Required | N | 14 | Request Timestamp (YYYYMMDDHH24MISS) | 20221114114338 |
tXid Required | AN | 30 | Transaction Id | PAYLOANTES06202212051018325178 |
iMid Required | AN | 10 | Merchant ID | PAYLOANTES |
referenceNo Required | ANS | 40 | Merchant Order No | ORD12345 |
amt Required | N | 12 | Transaction Amount | 10000 |
merchantToken Required | AN | 255 | merchant token | 3a04d0c8581ae37727f87130a0b32f2fe9fe39c66b88347352e7b90aeb5cb6e6 |
The following is a list of responses to request status inquiries on Payloan transaction processes.
Parameter | Type | Size | Description | Example / Notes |
resultCd | N | 4 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | init |
tXid | AN | 30 | Transaction ID | PAYLOANTES06202212051018325178 |
iMid | AN | 10 | Merchant Id | PAYLOANTES |
referenceNo | ANS | 40 | Merchant Ref. No | ORD12345 |
payMethod | N | 2 | 06 | |
amt | N | 12 | Payment Amount | 10000 |
CancelAmt | N | 12 | Cancel amount | Null |
reqDt | N | 8 | Transaction request date (YYYYMMDD) | 20221205 |
reqTm | N | 6 | Transaction request time (HH24MISS) | 101832 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | Null |
transTm | N | 6 | Transction 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 | Test Transaction Nicepay |
billingNm | A | 100 | Buyer name | John Doe |
status | N | 1 | 9 | |
instmntMon | N | 2 | Installment Month | 1 |
instmntType | N | 2 | 2 | |
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 | VA Number | Null |
bankCd | A | 4 | Null | |
payNo | N | 12 | Payment Number | Null |
mitraCd | A | 4 | KDVI | |
receiptCode | ANS | 20 | Authorization Number | Null |
cancelAmt | N | 12 | Cancel Amount | Null |
recurringToken | AN | 255 | Recurring Token (Needed for Recurring Payment) | |
ccTransType | N | 2 | Null | |
payValidDt | N | 8 | CVS expiry date (YYYYMMDD) (CVS) | Null |
payValidTm | N | 6 | CVS expiry time (HH24MISS) (CVS) | Null |
mRefNo | AN | 20 | Bank reference No (Direct Debit) | Null |
acquStatus | N | 2 | Purchase Status 1: Normal 2: Recurring 3: Pre-auth 4: Capture | Null |
cardExpYymm | N | 4 | Expiry (YYMM) | Null |
acquBankNm | A | 255 | Acquiring Bank Name | Null |
issuBankNm | A | 255 | Issuing Bank Name | Null |
paymentExpDt | N | 6 | QR Payment Expiry Date (YYYYMMDD) | Null |
paymentExpTm | N | 6 | QR Payment Expiry Time (HH24MISS) | Null |
cancelTrxSn | AN | 32 | Cancel Transaction Number | Null |
userId | AN | 128 | QRIS User ID Hash | Null |
shopId | AN | 32 | Shop Id | Null |
The following is additional response list information from request status inquiry in other transaction processes.
Parameter | Type | Size | Description |
mitraCd | A | 4 | Mitra Code (CVS, Direct Debit, E-Wallet, Payloan) |
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 | Bank reference No (Direct Debit) |