NICEPAY API
...
Payment API
API QRIS

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

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

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