Status Inquiry - API QRIS

10min

Tentang API QRIS Status Inquiry 

﻿
Integrasi 
﻿ Status Inquiry pada 
﻿ diperlukan supaya 
﻿ dapat memeriksa 
﻿ 
﻿ berlangsung pada 
﻿ 
﻿ dengan 
﻿ success, fail, dan lainnya. Sehingga, 
﻿ dapat memiliki laporan mengenai 
﻿ tersebut.
﻿
API QRIS Status Inquiry 
﻿
Integrasi Status Inquiry pada 
﻿ bertujuan bagi 
﻿ agar dapat terhubung dengan 
﻿ 
﻿ untuk melakukan pemeriksaan 
﻿ pada 
﻿ 
﻿.

API End Point
/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
Ketika 
﻿ diterima dbProcessUrl 
﻿, kami sangat memberi saran kepada 
﻿ untuk melakukan verifikasi 
﻿ tersebut dengan menggunakan Status Inquiry - API QRIS﻿.
Notification Handling sangat berguna untuk meminimalisir terjadinya Fraud. Kami sangat menganjurkan 
﻿ untuk melakukan verifikasi Notification Handling. 
﻿ dapat membaca 
﻿ lebih rinci mengenai Notification Handling pada Notification - API QRIS﻿.
﻿
Request Parameter for QRIS Status Inquiry  
﻿
Berikut ini adalah daftar 
﻿ untuk melakukan request 
﻿ inquiry pada 
﻿ 
﻿ 
﻿. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
timeStamp
﻿Required
N
14
Request Timestamp (YYYYMMDDHH24MISS)
20221208091279
tXid
Required
﻿
AN
30
Transaction ID
IONPAYTEST08202212080918308275
iMid
﻿Required
﻿
AN
10
﻿
﻿ ID
IONPAYTEST
referenceNo
Required
﻿
ANS
40
﻿
﻿ Order Number
ORD54321

amt
Required
﻿
N
12
Transaction Amount	
5
merchantToken
Required
﻿
AN
255
﻿
﻿ Token
52d30865f174e445cf731403b010ae099314edea9c399f7940fb2020d4045465
﻿
Response Parameter for QRIS Status Inquiry  
﻿
Berikut ini adalah daftar response dari request status inquiry pada proses transaksi QRIS. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
resultCd
N
4
﻿Result Code﻿ 
0000
resultMsg
AN
255
Result Message: Error Code﻿ 
PAID
tXid
AN
30
Transaction ID
IONPAYTEST08202212080918308275
iMid
AN
10
﻿
﻿ ID
IONPAYTEST
referenceNo
ANS
40
﻿
﻿ Reference Number
ORD54321
payMethod
N
2
﻿Payment Method Code﻿ 
08
amt
N
12
﻿
﻿ Amount
5
CancelAmt
N
12
Cancel Amount
null
reqDt
N
8
Transaction Request Date (YYYYMMDD)
20221208
reqTm
N
6
Transaction Request Time (HH24MISS)
091830
transDt
N
8
Transaction Date (YYYYMMDD)
20221208
transTm
N
6
Transction Time (HH24MISS)
091830
depositDt
N
8
Transaction Deposit Date (YYYYMMDD)
Null
depositTm
N
6
Transaction Deposit Time (HH24MISS)
﻿
mitraCd
A
4
﻿Mitra Code﻿ 
QSHP
instmntMon
N
2
Installment Month
Null
instmntType
N
2
﻿Installment Type Code﻿ 
1
cardNo
N
20
﻿
﻿ Number 
Null
preauthToken
AN
64
Pre-Auth Token
Null
acquBankCd
A
4
﻿Acquiring Bank Code﻿ 
Null
issuBankCd
A
4
﻿Issuing Bank Code﻿ 
Null
vacctValidDt
N
8
VA Expiry Date (YYYYMMDD)	
Null
vacctValidTm
N
6
VA Expiry Time (HH24MISS)
Null
vacctNo
N
20
﻿
﻿ Number
Null
bankCd
A
4
﻿Bank Code﻿ 
Null
payNo
N
12
CVS Number (CVS)
Null  
﻿
(For CVS)
receiptCodeF
ANS
20
Authorization Number
Null 
﻿
(For 
﻿)
recurringToken
AN
64
Recurring 
﻿ Token	
Null 
﻿
(For CC)
ccTransType
N
2
﻿Credit Card Transaction Type﻿﻿
Null 
﻿
(For CC)
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 
﻿
(For CC)
cardExpYymm
N
4
Card Expiration (YYMM)

Null 
﻿
(For CC)
acquBankNm
A
4
Acquiring 
﻿ Name
Null 
﻿
(For CC)
issuBankNm
A
255
Issuing 
﻿ Name
Null 
﻿
(For CC)
depositDt
N
8
Deposit Date (YYYYMMDD)
Null 
﻿
(For VA)
depositTm
N
6
Deposit Time (HH24MISS)
Null 
﻿
(For VA)
paymentExpDt
N
6
QR 
﻿ Expiry Date (YYYYMMDD)
20221208
paymentExpTm
N
6
QR 
﻿ Expiry Time (HH24MISS)
092330
paymentTrxSn
N
32
﻿
﻿ Transaction Number
115045570008290314
cancelTrxSn
AN
32
Cancel Transaction Number
null
currency
A
3
Currency
IDR
goodsNm
AN
100
Goods Name
Test Transaction 
﻿ 
billingNm
A
100
Buyer Name
Andi Pamungkas
status
N
1
﻿Payment Status Code﻿﻿
0
userId
AN
128 
 
﻿ User ID Hash
115045570008290314
shopId
AN
32
Shop ID
﻿
﻿ 
﻿
Additional Response Parameter for QRIS Status Inquiry
﻿
Berikut ini adalah 
﻿ daftar response tambahan dari request 
﻿ inquiry pada 
﻿ 
﻿ 
﻿.
Parameter
Tipe
Ukuran
Deskripsi
mitraCd
A
4
﻿Mitra Code﻿﻿
cancelAmt
N
12
Cancel Amount
paymentTrxSn
N
32
﻿
﻿ Transaction Number
paymentExpDt
N
6
QR 
﻿ Expiry Date (YYYYMMDD)
shopId
AN
32
Shop ID
paymentExpTm
N
6
QR 
﻿ Expiry Time (HH24MISS)
cancelTrxSn
AN
32
Cancel Transaction Number
userId
AN
128
﻿
﻿ User ID Hash
﻿

Sample JSON for QRIS Status Inquiry 
﻿
JSON Request
JSON Response
Java Request
{
	"timeStamp":"20221208091279",
	"tXid":"IONPAYTEST08202212080918308275",
	"iMid":"IONPAYTEST",
	"referenceNo":"ORD54321",
	"amt":"5",
	"merchantToken":"52d30865f174e445cf731403b010ae099314edea9c399f7940fb2020d4045465"
}
{
	"timeStamp":"20221208091279",
	"tXid":"IONPAYTEST08202212080918308275",
	"iMid":"IONPAYTEST",
	"referenceNo":"ORD54321",
	"amt":"5",
	"merchantToken":"52d30865f174e445cf731403b010ae099314edea9c399f7940fb2020d4045465"
}
﻿
﻿

API End Point	/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

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
timeStamp Required	N	14	Request Timestamp (YYYYMMDDHH24MISS)	20221208091279
tXid Required	AN	30	Transaction ID	IONPAYTEST08202212080918308275
iMid Required	AN	10	ID	IONPAYTEST
referenceNo Required	ANS	40	Order Number	ORD54321
amt Required	N	12	Transaction Amount	5
merchantToken Required	AN	255	Token	52d30865f174e445cf731403b010ae099314edea9c399f7940fb2020d4045465

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
resultCd	N	4	Result Code	0000
resultMsg	AN	255	Result Message: Error Code	PAID
tXid	AN	30	Transaction ID	IONPAYTEST08202212080918308275
iMid	AN	10	ID	IONPAYTEST
referenceNo	ANS	40	Reference Number	ORD54321
payMethod	N	2	Payment Method Code	08
amt	N	12	Amount	5
CancelAmt	N	12	Cancel Amount	null
reqDt	N	8	Transaction Request Date (YYYYMMDD)	20221208
reqTm	N	6	Transaction Request Time (HH24MISS)	091830
transDt	N	8	Transaction Date (YYYYMMDD)	20221208
transTm	N	6	Transction Time (HH24MISS)	091830
depositDt	N	8	Transaction Deposit Date (YYYYMMDD)	Null
depositTm	N	6	Transaction Deposit Time (HH24MISS)
mitraCd	A	4	Mitra Code	QSHP
instmntMon	N	2	Installment Month	Null
instmntType	N	2	Installment Type Code	1
cardNo	N	20	Number	Null
preauthToken	AN	64	Pre-Auth Token	Null
acquBankCd	A	4	Acquiring Bank Code	Null
issuBankCd	A	4	Issuing Bank Code	Null
vacctValidDt	N	8	VA Expiry Date (YYYYMMDD)	Null
vacctValidTm	N	6	VA Expiry Time (HH24MISS)	Null
vacctNo	N	20	Number	Null
bankCd	A	4	Bank Code	Null
payNo	N	12	CVS Number (CVS)	Null (For CVS)
receiptCodeF	ANS	20	Authorization Number	Null (For )
recurringToken	AN	64	Recurring Token	Null (For CC)
ccTransType	N	2	Credit Card Transaction Type	Null (For CC)
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 (For CC)
cardExpYymm	N	4	Card Expiration (YYMM)	Null (For CC)
acquBankNm	A	4	Acquiring Name	Null (For CC)
issuBankNm	A	255	Issuing Name	Null (For CC)
depositDt	N	8	Deposit Date (YYYYMMDD)	Null (For VA)
depositTm	N	6	Deposit Time (HH24MISS)	Null (For VA)
paymentExpDt	N	6	QR Expiry Date (YYYYMMDD)	20221208
paymentExpTm	N	6	QR Expiry Time (HH24MISS)	092330
paymentTrxSn	N	32	Transaction Number	115045570008290314
cancelTrxSn	AN	32	Cancel Transaction Number	null
currency	A	3	Currency	IDR
goodsNm	AN	100	Goods Name	Test Transaction
billingNm	A	100	Buyer Name	Andi Pamungkas
status	N	1	Payment Status Code	0
userId	AN	128	User ID Hash	115045570008290314
shopId	AN	32	Shop ID

Parameter	Tipe	Ukuran	Deskripsi
mitraCd	A	4	Mitra Code
cancelAmt	N	12	Cancel Amount
paymentTrxSn	N	32	Transaction Number
paymentExpDt	N	6	QR Expiry Date (YYYYMMDD)
shopId	AN	32	Shop ID
paymentExpTm	N	6	QR Expiry Time (HH24MISS)
cancelTrxSn	AN	32	Cancel Transaction Number
userId	AN	128	User ID Hash

Updated 18 Sep 2024

Did this page help you?

Registration - API QRIS

Notification - API QRIS

Status Inquiry - API QRIS

Tentang API QRIS Status Inquiry

API QRIS Status Inquiry

Request Parameter for QRIS Status Inquiry

Response Parameter for QRIS Status Inquiry

Additional Response Parameter for QRIS Status Inquiry

Sample JSON for QRIS Status Inquiry

Selamat Datang di NICEPAY DOCS