Notification - API QRIS

7min

Tentang API QRIS Notification
﻿
﻿﻿ mengirimkan push notification ﻿ dikirim melalui dbProcessUrl ﻿. ﻿ harus memastikan tidak melakukan Blacklist IP ﻿ dan melakukan Whitelist IP ﻿ untuk mendapatkan push notification ﻿ hanya dikirim dari server ﻿.
Request Method 
﻿POST﻿
Merchant Token
SHA256 ( iMid+  tXid + amt+ merchantKey)
IP
103.20.51.0/24
103.117.8.0/24
User-Agent
User-Agent: Jakarta Commons-HttpClient/3.1
﻿
Notification Parameter QRIS Notification
﻿
Ketika ﻿ diterima pada dbProcessUrl ﻿, kami sangat menyarankan ﻿ untuk melakukan verifikasi ﻿ kembali dengan menggunakan Status Inquiry - API QRIS﻿.
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
tXid
N
30
Transaction ID
IONPAYTEST08202212141041407785
merchantToken
AN
255
﻿﻿ Token
69ba08191f47af25dd3ea089a99f89a6cb05295f9e641a78e8e44f5f75891cc7
referenceNo
ANS
40
﻿﻿ Order Number
ORD54321
payMethod
N
2
﻿Payment Method Code﻿ 
08
paymentTrxSn
AN
32
﻿﻿ Transaction Number
112160983971452364
userId
AN
128
﻿﻿ User ID Hash
8bf254cdb4dfff447233a67e796556db7653c40234edb979614f007dfa8eb7c1
amt
N
12
﻿﻿ Amount
5
mitraCd
N
4
﻿Mitra Code﻿ 
QSHP
transDt
N
8
Transaction Date
20221214
transTm
N
6
Transaction Time
104140
currency
A
3
Currency
IDR
goodsNm
AN
100
Goods Name
Test+Transaction+﻿ 
billingNm
A
100
Billing Name
Andi+Pamungkas
matchCl
N
1
﻿﻿ Flag: 
﻿Notification Match Amount Indicator﻿ 
1
status
A
1
Deposit Status: Notification Status Code﻿ 
0 : Deposit
1 : Reversal
0
shopId
﻿Required for QRIS
AN
32
Shop ID
﻿﻿ 
﻿
Additional Parameter for QRIS Notification
﻿
Parameter
Tipe
Ukuran
Deskripsi
paymentTrxSn
AN
32
﻿﻿ Transaction Number
userId
AN
128
﻿﻿ User ID Hash
shopId
AN
32
Shop ID
Merchant Token ﻿ diterima dari Notification, ﻿ harus melakukan perbandingan kembali secara internal untuk mencegah ﻿ palsu/tidak berlaku.
 
💡Contoh Kasus:
Misalnya, ﻿ memiliki merchantKey ﻿ digunakan untuk melakukan generate token, yaitu 1234. Ketika merchantToken ﻿ di-generate ﻿ diketahui adalah abcd, sementara merchantToken ﻿ didapatkan pada ﻿ adalah abdd, maka ﻿ tersebut dianggap palsu/tidak berlaku.
﻿
Sample for QRIS Notification
﻿
Sample POST for QRIS  Notification
merchantToken = 69ba08191f47af25dd3ea089a99f89a6cb05295f9e641a78e8e44f5f75891cc7 
goodsNm = Test+Transaction+Nicepay 
referenceNo = ORD54321  
transTm = 104140  
mitraCd = QSHP
tXid = IONPAYTEST08202212141041407785
amt = 5
paymentTrxSn = 112160983971452364
userId = 8bf254cdb4dfff447233a67e796556db7653c40234edb979614f007dfa8eb7c1
billingNm = Andi+pamungkas
matchCl = 1
payMethod = 08
currency = IDR
shopId = NICEPAY
transDt = 20221214
status = 0
merchantToken = 69ba08191f47af25dd3ea089a99f89a6cb05295f9e641a78e8e44f5f75891cc7 
goodsNm = Test+Transaction+Nicepay 
referenceNo = ORD54321  
transTm = 104140  
mitraCd = QSHP
tXid = IONPAYTEST08202212141041407785
amt = 5
paymentTrxSn = 112160983971452364
userId = 8bf254cdb4dfff447233a67e796556db7653c40234edb979614f007dfa8eb7c1
billingNm = Andi+pamungkas
matchCl = 1
payMethod = 08
currency = IDR
shopId = NICEPAY
transDt = 20221214
status = 0
﻿

Request Method	POST
Merchant Token	SHA256 ( iMid+ tXid + amt+ merchantKey)
IP	103.20.51.0/24 103.117.8.0/24
User-Agent	User-Agent: Jakarta Commons-HttpClient/3.1

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
tXid	N	30	Transaction ID	IONPAYTEST08202212141041407785
merchantToken	AN	255	Token	69ba08191f47af25dd3ea089a99f89a6cb05295f9e641a78e8e44f5f75891cc7
referenceNo	ANS	40	Order Number	ORD54321
payMethod	N	2	Payment Method Code	08
paymentTrxSn	AN	32	Transaction Number	112160983971452364
userId	AN	128	User ID Hash	8bf254cdb4dfff447233a67e796556db7653c40234edb979614f007dfa8eb7c1
amt	N	12	Amount	5
mitraCd	N	4	Mitra Code	QSHP
transDt	N	8	Transaction Date	20221214
transTm	N	6	Transaction Time	104140
currency	A	3	Currency	IDR
goodsNm	AN	100	Goods Name	Test+Transaction+
billingNm	A	100	Billing Name	Andi+Pamungkas
matchCl	N	1	Flag: Notification Match Amount Indicator	1
status	A	1	Deposit Status: Notification Status Code 0 : Deposit 1 : Reversal	0
shopId Required for QRIS	AN	32	Shop ID

Parameter	Tipe	Ukuran	Deskripsi
paymentTrxSn	AN	32	Transaction Number
userId	AN	128	User ID Hash
shopId	AN	32	Shop ID

Status Inquiry - API QRIS

Cancel - API QRIS

Notification - API QRIS

Tentang API QRIS Notification

Notification Parameter QRIS Notification

Additional Parameter for QRIS Notification

Sample for QRIS Notification

Selamat Datang di NICEPAY DOCS