Notification - API Paylater

7 min

Tentang API Paylater Notification

NICEPAY mengirimkan push notification yang dikirim melalui dbProcessUrl Merchant. Merchant harus memastikan tidak melakukan Blacklist IP NICEPAY dan melakukan Whitelist IP NICEPAY untuk mendapatkan push notification yang hanya dikirim dari server NICEPAY.

Request Method	POST
Merchant Token	SHA256 ( iMid+ tXid + amt+ merchantKey)
IP	IP Public environtment Production: 103.20.51.34 103.20.51.33 18.98.96.50 IP Public environtment Dev: 103.20.51.39 103.20.51.40 18.98.96.54
User-Agent	User-Agent: Jakarta Commons-HttpClient/3.1

Notification Parameter Paylater Notification

Ketika notifikasi diterima pada dbProcessUrl Anda, kami sangat menyarankan Merchant untuk melakukan verifikasi notifikasi kembali dengan menggunakan Status Inquiry - API Paylater.

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
tXid	N	30	Transaction ID	PAYLOANTES06202212141610281704
merchantToken	AN	255	Merchant Token	0716e8cbb7bac584efa98df5021543e11fab1a520415f1382572eadcca81107f
referenceNo	ANS	40	Merchant Order Number	ord20221214161263
payMethod	N	2	Payment Method Code	06
amt	N	12	Payment Amount	25145
goodsNm	AN	100	Goods Name	Testing
matchCl	N	1	Payment Flag: Notification Match Amount Indicator	Null
status	A	1	Deposit Status: Notification Status Code 0 : Deposit 1 : Reversal	0
mitraCd	A	4	Mitra Code	KDVI
transTm	N	6	Transaction Time (HH24MISS)	155852
clientUserKey Mandatory if tokenize	AN	100	User Key, Must be Unique for Each Customer	1134431
billingNm	A	100	Buyer Name	John-Doe
transDt	N	8	Transaction Date	20221214
currency	A	3	Currency	IDR
tokenizeUser	N	1	Transaction Tokenize Type	1
userToken	ANS	255	User Token	12345eea9-6234-6789-12r3-123re3456tt5

Additional Parameter for Others Payment Method Notification

Parameter	Tipe	Ukuran	Deskripsi
mitraCd	A	4	Mitra Code
payNo	N	12	Payment Number
payValidDt	N	8	Expiry Date (YYYYMMDD)
payValidTm	N	6	Expiry Time (HH24MISS)
receiptCode	ANS	20	Authorization Number
mRefNo	AN	18	Reference Number
depositDt	N	8	Deposit Date (YYYYMMDD)
depositTm	N	6	Deposit Time (HH24MISS)

Merchant Token yang diterima dari Notification, Merchant harus melakukan perbandingan kembali secara internal untuk mencegah notifikasi palsu/tidak berlaku.

💡Contoh Kasus:

Misalnya, Anda memiliki merchantKey yang digunakan untuk melakukan generate token, yaitu 1234. Ketika merchantToken yang di-generate Merchant diketahui adalah abcd, sementara merchantToken yang didapatkan pada notifikasi adalah abdd, maka notifikasi tersebut dianggap palsu/tidak berlaku.

Sample for Paylater Notification