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
﻿
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
﻿
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

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