V1 Check Transaction Status

11min

About V1 Check Transaction Status
﻿


This 
﻿
 is intends to check 
﻿ 
﻿ of 
﻿ 
﻿. 
When a 
﻿ received on 
﻿ dbProcessUrl, 
﻿ strongly recommend 
﻿ to verify 
﻿ 
﻿ using 
﻿ V1 Check Transaction Status﻿.
When callbackurl is received, we strongly recommend 
﻿ to verify 
﻿ 
﻿ by using 
﻿ V1 Check Transaction Status﻿. 
CallBack Handling is very helpful to minimize Fraud actions, we strongly recommend 
﻿s to verify 
﻿ CallBack Handling.

CallBack Handling Flow
CallBack Handling Flow
﻿
Steps description :
﻿
﻿ do 
﻿.
﻿
﻿ request 
﻿ to 
﻿.
﻿
﻿ send response CallBack and 
﻿ Result (callBackUrl) to 
﻿.
﻿
﻿ check 
﻿ 
﻿.
﻿
﻿ send 
﻿ 
﻿ to 
﻿.
﻿
﻿ return response (Final Status Flag) to 
﻿.
﻿
API Check Transaction Status
﻿
API Endpoint
/nicepay/api/onePassStatus.do
Request Method application/x-www-form-urlencoded﻿
﻿POST﻿
Description
Inquires 
﻿ 
﻿ to 
﻿ server.
Merchant Token
SHA256(iMid+referenceNo+amt+merchantKey)
Notification Handling it is very helpful to minimize Fraud actions, we strongly recommend 
﻿s to verify 
﻿ Notification Handling.
Notification Handling Flow
Notification Handling Flow
﻿
Steps description:
﻿
﻿ do 
﻿.
﻿
﻿ send 
﻿ to 
﻿.
﻿
﻿ send Notification URL (dbProcessUrl) to 
﻿.
﻿
﻿ check 
﻿ 
﻿.
﻿
﻿ send 
﻿ 
﻿ to 
﻿.
﻿
﻿ return response (final 
﻿ flag) to 
﻿.
﻿
Request Parameters - Check Status
Check Status - Request Parameter
// Order Status Mandatory Field    
nicePay.setTrxId("IONPAYTEST02201603091207051498");    
nicePay.setReferenceNo("MerchantReferenceNumber001");    
nicePay.setAmt("1000");    
nicePay.setMerchantToken(nicePay.makeToken(nicePay.getAmt(), nicePay.getReferenceNo()));    
// Order Status Request    
nicePay.orderStatus();    
// Order Status Response    
System.out.println("Response String : " + nicePay.getResponseString()); // JSON in String format    
nicePay.getHtResponse(); // JSON in HashTable<String, String> format    

String resultCd = nicePay.Get("resultCd");           
String resultMsg = nicePay.Get("resultMsg");           
String tXid= nicePay.Get("tXid ");           
String iMid= nicePay.Get("iMid");     
String currency= nicePay.Get("currency");  
String amount= nicePay.Get("amount");           
String instmntMon= nicePay.Get("instmntMon");           
String instmntType= nicePay.Get("instmntType");     
String referenceNo= nicePay.Get("referenceNo");    
String goodsNm = nicePay.Get("goodsNm");           
String payMethod = nicePay.Get("payMethod");           
String billingNm= nicePay.Get("billingNm");           
String merchantToken= nicePay.Get("merchantToken");     
String reqDt= nicePay.Get("reqDt");    
String reqTm = nicePay.Get("reqTm");           
String status = nicePay.Get("status");           
String bankCd= nicePay.Get("bankCd");  
String vacctValidDt= nicePay.Get("vacctValidDt");            
String vacctValidTm= nicePay.Get("vacctValidTm");     
String vacctNo= nicePay.Get("vacctNo");
// Order Status Mandatory Field    
nicePay.setTrxId("IONPAYTEST02201603091207051498");    
nicePay.setReferenceNo("MerchantReferenceNumber001");    
nicePay.setAmt("1000");    
nicePay.setMerchantToken(nicePay.makeToken(nicePay.getAmt(), nicePay.getReferenceNo()));    
// Order Status Request    
nicePay.orderStatus();    
// Order Status Response    
System.out.println("Response String : " + nicePay.getResponseString()); // JSON in String format    
nicePay.getHtResponse(); // JSON in HashTable<String, String> format    

String resultCd = nicePay.Get("resultCd");           
String resultMsg = nicePay.Get("resultMsg");           
String tXid= nicePay.Get("tXid ");           
String iMid= nicePay.Get("iMid");     
String currency= nicePay.Get("currency");  
String amount= nicePay.Get("amount");           
String instmntMon= nicePay.Get("instmntMon");           
String instmntType= nicePay.Get("instmntType");     
String referenceNo= nicePay.Get("referenceNo");    
String goodsNm = nicePay.Get("goodsNm");           
String payMethod = nicePay.Get("payMethod");           
String billingNm= nicePay.Get("billingNm");           
String merchantToken= nicePay.Get("merchantToken");     
String reqDt= nicePay.Get("reqDt");    
String reqTm = nicePay.Get("reqTm");           
String status = nicePay.Get("status");           
String bankCd= nicePay.Get("bankCd");  
String vacctValidDt= nicePay.Get("vacctValidDt");            
String vacctValidTm= nicePay.Get("vacctValidTm");     
String vacctNo= nicePay.Get("vacctNo");
﻿
Parameter
Type
Size
Description
Example / Notes
iMid
﻿Required﻿
AN
10
﻿
﻿ ID
IONPAYTEST
merchantToken
﻿Required
﻿
AN
255
﻿
﻿ Token
6cfccfc0046773c1b89d8e98c...
tXid
Required
﻿
AN

30
Transaction ID
IONPAYTEST02201607291027025291
amt
Required
﻿
N

12
Goods Amount
15000
referenceNo
Required﻿
ANS
40
﻿
﻿ Order Number
OrdNo123124
﻿
Response Object - Check Status
Check Status - Response Parameter
{
    "tXid": "NORMALTEST01202002031344071337",
    "iMid": "NORMALTEST",
    "currency": "IDR",
    "amt": "12000",
    "instmntMon": "1",
    "instmntType": "1",
    "referenceNo": "ord20200203130299",
    "goodsNm": "Testing Normal FULL PAYMENT CC Va",
    "payMethod": "01",
    "billingNm": "Customer Name",
    "reqDt": "20200203",
    "reqTm": "134407",
    "status": "9",
    "resultCd": "0000",
    "resultMsg": "init",
    "cardNo": null,
    "preauthToken": null,
    "acquBankCd": null,
    "issuBankCd": null,
    "vacctValidDt": null,
    "vacctValidTm": null,
    "vacctNo": null,
    "bankCd": null,
    "payNo": null,
    "mitraCd": null,
    "receiptCode": null,
    "cancelAmt": null,
    "transDt": null,
    "transTm": null,
    "recurringToken": null,
    "ccTransType": null,
    "payValidDt": null,
    "payValidTm": null,
    "mRefNo": null,
    "acquStatus": null,
    "cardExpYymm": null,
    "acquBankNm": null,
    "issuBankNm": null,
    "depositDt": null,
    "depositTm": null,
    "acquirerData": {
        "rrn": "332510237487"
    }
}
{
    "tXid": "NORMALTEST01202002031344071337",
    "iMid": "NORMALTEST",
    "currency": "IDR",
    "amt": "12000",
    "instmntMon": "1",
    "instmntType": "1",
    "referenceNo": "ord20200203130299",
    "goodsNm": "Testing Normal FULL PAYMENT CC Va",
    "payMethod": "01",
    "billingNm": "Customer Name",
    "reqDt": "20200203",
    "reqTm": "134407",
    "status": "9",
    "resultCd": "0000",
    "resultMsg": "init",
    "cardNo": null,
    "preauthToken": null,
    "acquBankCd": null,
    "issuBankCd": null,
    "vacctValidDt": null,
    "vacctValidTm": null,
    "vacctNo": null,
    "bankCd": null,
    "payNo": null,
    "mitraCd": null,
    "receiptCode": null,
    "cancelAmt": null,
    "transDt": null,
    "transTm": null,
    "recurringToken": null,
    "ccTransType": null,
    "payValidDt": null,
    "payValidTm": null,
    "mRefNo": null,
    "acquStatus": null,
    "cardExpYymm": null,
    "acquBankNm": null,
    "issuBankNm": null,
    "depositDt": null,
    "depositTm": null,
    "acquirerData": {
        "rrn": "332510237487"
    }
}
﻿

Parameter
Type
Size
Description
resultCd
N
4
﻿Result Code﻿﻿
resultMsg
AN
255
﻿Result Message﻿﻿
tXid
AN
30
Transaction ID
referenceNo
ANS
40
﻿
﻿ Reference Number
payMethod
N
2
﻿Payment Method﻿﻿
amt
N
12
﻿
﻿ Amount
reqDt
N
8
Transaction Date (YYYYMMDD)
reqTm
N
6
Transaction Time (HH24MISS)
currency
A
3
Currency
goodsNm
AN
100
Goods Name
billingNm
AN
30
Billing Name
status
N
1
﻿Payment Status Code﻿﻿
instmntMon
N
2
Installment Month
instmntType
N
2
﻿Installment Type﻿﻿
acquirerData
Array
20
A dynamic array consisting of a unique reference number RRN that is provided by 
﻿ Banking 
﻿ when a refund is 
﻿ed. This reference number can be used by 
﻿ 
﻿ to track 
﻿ 
﻿ of 
﻿ refund with 
﻿ 
﻿.
Additional Response for Virtual Account
Parameter
Type
Size 
Description
vacctValidDt
N
8
VA Validity Date (YYYYMMDD)
vacctValidTm
N
6
VA Validity Time (HH24MISS)
vacctNo
N
16
VA Number
bankCd
A
4
﻿Bank Code﻿﻿
Additional Response for QRIS
Parameter
Type
Size
Description
mitraCd
A
4
﻿Mitra Code﻿ (QRIS)
cancelAmt
N
12
Cancel Amount
paymentTrxSn
AN
32
﻿
﻿ Transaction Number
paymentExpDt
N
6
QR 
﻿ Expired Date (YYYYMMDD)
shopId
AN
32
Shop ID
transTm
N
6
Transaction Time (HH24MISS)
paymentExpTm
N
6
QR 
﻿ Expired Time (HH24MISS)
cancelTrxSn
AN
32
Cancel Transaction Number
userId
AN
128
﻿
﻿ User ID Hash
transDt
N
8
Transaction Date (YYYYMMDD)
depositDt
N
8
Transaction Deposit (YYYYMMDD)
depositTm
N
6
Transaction Deposit Time (HH24MISS)
Additional Response for Others Payment Method
Parameter
Type
Size
Description
mitraCd
A
4
﻿Mitra Code﻿ (CVS, E-Wallet, Payloan)
payNo
N
12
﻿
﻿ Number (CVS)
payValidDt
N
8
CVS 
﻿ Expired Date (YYYYMMDD)
payValidTm
N
6
CVS 
﻿ Expired Time (HH24MISS)
receiptCode
ANS
18
Authorization Number
﻿

API Endpoint	/nicepay/api/onePassStatus.do
Request Method application/x-www-form-urlencoded	POST
Description	Inquires to server.
Merchant Token	SHA256(iMid+referenceNo+amt+merchantKey)

Parameter	Type	Size	Description	Example / Notes
iMid Required	AN	10	ID	IONPAYTEST
merchantToken Required	AN	255	Token	6cfccfc0046773c1b89d8e98c...
tXid Required	AN	30	Transaction ID	IONPAYTEST02201607291027025291
amt Required	N	12	Goods Amount	15000
referenceNo Required	ANS	40	Order Number	OrdNo123124

Parameter	Type	Size	Description
resultCd	N	4	Result Code
resultMsg	AN	255	Result Message
tXid	AN	30	Transaction ID
referenceNo	ANS	40	Reference Number
payMethod	N	2	Payment Method
amt	N	12	Amount
reqDt	N	8	Transaction Date (YYYYMMDD)
reqTm	N	6	Transaction Time (HH24MISS)
currency	A	3	Currency
goodsNm	AN	100	Goods Name
billingNm	AN	30	Billing Name
status	N	1	Payment Status Code
instmntMon	N	2	Installment Month
instmntType	N	2	Installment Type
acquirerData	Array	20	A dynamic array consisting of a unique reference number RRN that is provided by Banking when a refund is ed. This reference number can be used by to track of refund with .

Parameter	Type	Size	Description
vacctValidDt	N	8	VA Validity Date (YYYYMMDD)
vacctValidTm	N	6	VA Validity Time (HH24MISS)
vacctNo	N	16	VA Number
bankCd	A	4	Bank Code

Parameter	Type	Size	Description
mitraCd	A	4	Mitra Code (QRIS)
cancelAmt	N	12	Cancel Amount
paymentTrxSn	AN	32	Transaction Number
paymentExpDt	N	6	QR Expired Date (YYYYMMDD)
shopId	AN	32	Shop ID
transTm	N	6	Transaction Time (HH24MISS)
paymentExpTm	N	6	QR Expired Time (HH24MISS)
cancelTrxSn	AN	32	Cancel Transaction Number
userId	AN	128	User ID Hash
transDt	N	8	Transaction Date (YYYYMMDD)
depositDt	N	8	Transaction Deposit (YYYYMMDD)
depositTm	N	6	Transaction Deposit Time (HH24MISS)

Parameter	Type	Size	Description
mitraCd	A	4	Mitra Code (CVS, E-Wallet, Payloan)
payNo	N	12	Number (CVS)
payValidDt	N	8	CVS Expired Date (YYYYMMDD)
payValidTm	N	6	CVS Expired Time (HH24MISS)
receiptCode	ANS	18	Authorization Number

Updated 08 Oct 2024

Did this page help you?

QRIS - V1 Enterprise

V1 Cancel Transaction

V1 Check Transaction Status

About V1 Check Transaction Status

CallBack Handling Flow

API Check Transaction Status

Notification Handling Flow

Request Parameters - Check Status

Response Object - Check Status

Additional Response for Virtual Account

Additional Response for QRIS

Additional Response for Others Payment Method

Welcome to NICEPAY DOCS