V1 Check Transaction Status

11min

Tentang V1 Check Transaction Status
﻿

﻿ ini berguna untuk memeriksa 
﻿ 
﻿.
Ketika Notifikasi di dbProcessUrl sudah diterima, sangat disarankan bagi 
﻿ untuk melakukan verifikasi menggunakan V1 Check Transaction Status﻿.
Ketika callbackUrl sudah diterima, kami merekomendasikan para 
﻿ untuk melakukan verifikasi Status dengan menggunakan V1 Check Transaction Status﻿.
CallBack Handling berguna untuk mengurangi aksi Fraud, kami merekomendasikan 
﻿ untuk melakukan verifikasi dengan CallBack Handling.

CallBack Handling Flow
CallBack Handling Flow
﻿
Deskripsi langkah:
﻿
﻿ melakukan checkout.
﻿
﻿ mengajukan 
﻿ kepada 
﻿.
﻿
﻿ mengirimkan response callback dan hasil 
﻿ (callBackUrl) kepada 
﻿.
﻿
﻿ memeriksa 
﻿.
﻿
﻿ mengirimkan 
﻿ kepada 
﻿.
﻿
﻿ mengirimkan response (final status flag) kepada 
﻿.
﻿
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 tersebut sangat membantu untuk meminimalisir tindakan Fraud, sangat disarankan bagi 
﻿ untuk melakukan Notification Handling.
Notification Handling Flow
Notification Handling Flow
﻿
Deskripsi langkah:
﻿
﻿ melakukan checkout.
﻿
﻿ mengirimkan 
﻿ kepada 
﻿.
﻿
﻿ mengirimkan URL 
﻿ (dbProcessUrl) kepada 
﻿.
﻿
﻿ memeriksa 
﻿.
﻿
﻿ mengirimkan 
﻿ kepada 
﻿.
﻿
﻿ mengembalikan response (final status flag) kepada 
﻿.
﻿
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
Tipe
Ukuran
Deskripsi
Contoh / Catatan
iMid
Required﻿
AN
10
﻿
﻿ ID
IONPAYTEST
merchantTokenRequired
﻿
AN
255
﻿
﻿ Token
6cfccfc0046773c1b89d8e98c...
tXid
Required
﻿
AN

30
Transaction ID
IONPAYTEST02201603091207051498
amt
Required
﻿
N

12
Goods Amount
1000
referenceNo
Required﻿
ANS
40
﻿
﻿ Order Number
MerchantReferenceNumber001
﻿
Response Parameter - 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﻿
Tipe
Ukuran
Deskipsi
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
﻿Transaction Status﻿﻿
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
Tipe
Ukuran 
Deskripsi
vacctValidDt
N
8
Batas Tanggal VA (YYYYMMDD)
vacctValidTm
N
6
Batas Waktu VA (HH24MISS)
vacctNo
N
16
Nomor VA
bankCd
A
4
﻿Bank Code﻿﻿
Additional Response for QRIS
Parameter
Tipe
Ukuran
Deskripsi
mitraCd
A
4
﻿Mitra Code﻿ (QRIS)
cancelAmt
N
12
Nominal Pembatalan
paymentTrxSn
AN
32
Nomor Pembayaran Transaksi
paymentExpDt
N
6
Batas Waktu Pembayaran QR (YYYYMMDD)
shopId
AN
32
Shop ID
transTm
N
6
Tanggal Transaksi (HH24MISS)
paymentExpTm
N
6
Batas Waktu Pembayaran QR (HH24MISS)
cancelTrxSn
AN
32
Nomor Pembatalan Transaksi
userId
AN
128
Hash ID Pengguna 
﻿﻿
transDt
N
8
Tanggal Transaksi (YYYYMMDD)
depositDt
N
8
Tanggal Transaksi Terbayar (YYYYMMDD)
depositTm
N
6
Tanggal Transaksi Terbayar (HH24MISS)
Additional Response for Others Payment Method
Parameter
Tipe
Ukuran
Deskripsi
mitraCd
A
4
﻿Mitra Code﻿ (CVS, 
﻿, 
﻿)
payNo
N
12
Nomor Pembayaran (CVS)
payValidDt
N
8
Batas Tanggal Pembayaran CVS (YYYYMMDD)
payValidTm
N
6
Batas Waktu Pembayaran CVS (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	Tipe	Ukuran	Deskripsi	Contoh / Catatan
iMid Required	AN	10	ID	IONPAYTEST
merchantTokenRequired	AN	255	Token	6cfccfc0046773c1b89d8e98c...
tXid Required	AN	30	Transaction ID	IONPAYTEST02201603091207051498
amt Required	N	12	Goods Amount	1000
referenceNo Required	ANS	40	Order Number	MerchantReferenceNumber001

Parameter	Tipe	Ukuran	Deskipsi
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	Transaction Status
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	Tipe	Ukuran	Deskripsi
vacctValidDt	N	8	Batas Tanggal VA (YYYYMMDD)
vacctValidTm	N	6	Batas Waktu VA (HH24MISS)
vacctNo	N	16	Nomor VA
bankCd	A	4	Bank Code

Parameter	Tipe	Ukuran	Deskripsi
mitraCd	A	4	Mitra Code (QRIS)
cancelAmt	N	12	Nominal Pembatalan
paymentTrxSn	AN	32	Nomor Pembayaran Transaksi
paymentExpDt	N	6	Batas Waktu Pembayaran QR (YYYYMMDD)
shopId	AN	32	Shop ID
transTm	N	6	Tanggal Transaksi (HH24MISS)
paymentExpTm	N	6	Batas Waktu Pembayaran QR (HH24MISS)
cancelTrxSn	AN	32	Nomor Pembatalan Transaksi
userId	AN	128	Hash ID Pengguna
transDt	N	8	Tanggal Transaksi (YYYYMMDD)
depositDt	N	8	Tanggal Transaksi Terbayar (YYYYMMDD)
depositTm	N	6	Tanggal Transaksi Terbayar (HH24MISS)

Parameter	Tipe	Ukuran	Deskripsi
mitraCd	A	4	Mitra Code (CVS, , )
payNo	N	12	Nomor Pembayaran (CVS)
payValidDt	N	8	Batas Tanggal Pembayaran CVS (YYYYMMDD)
payValidTm	N	6	Batas Waktu Pembayaran CVS (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

Tentang V1 Check Transaction Status

CallBack Handling Flow

API Check Transaction Status

Notification Handling Flow

Request Parameters - Check Status

Response Parameter - Check Status

Additional Response for Virtual Account

Additional Response for QRIS

Additional Response for Others Payment Method

Selamat Datang di NICEPAY DOCS