Notification - API Direct Debit
Tentang API Direct Debit Notification
NICEPAY akan mengirimkan push notification melalui parameter dbProcessUrl sesuai dengan informasi Merchant pada Registration - API Direct Debit. 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 Direct Debit Notification
Ketika notifikasi diterima pada dbProcessUrl Anda, kami sangat menyarankan Merchant untuk melakukan verifikasi notifikasi kembali dengan menggunakan Status Inquiry - API Direct Debit.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
|---|---|---|---|---|
tXid Required | N | 30 | Transaction ID | TNICECP04100202210201205567417 |
merchantToken Required | AN | 255 | Merchant Token | ecd49958d29595d09cd7ccab6057e9db119dfeb83676c27fb7649d3393b911aa |
referenceNo Required | ANS | 40 | Merchant Order Number | ORD20250307130386 |
mitraCd Required | A | 4 | JENC | |
payMethod Required | N | 2 | 04 | |
payNo Optional | N | 20 | Payment Number | 504100002539 |
payValidTm Optional | N | 6 | CVS Expiry Time (HH24MISS) | null |
payValidDt Optional | N | 8 | Expiry Date (YYYYMMDD) | null |
amt Required | N | 12 | Payment Amount | 10000 |
clientUserKey Mandatory if tokenize | AN | 100 | User Key, Must be Unique for Each Customer | 1134431 |
userToken Optional | ANS | 255 | User Token | 12345eea9-6234-6789-12r3-123re3456tt5 |
tokenizeUser Optional | N | 1 | Transaction Tokenize Type | 1 |
transDt Optional | N | 8 | Transaction Date | 20221020 |
transTm Optional | N | 6 | Transaction Time | 120803 |
currency Required | A | 3 | Currency | IDR |
goodsNm Required | AN | 100 | Goods Name | John Doe |
billingNm Required | A | 100 | Billing Name | John-Doe |
receiptCode Required | ANS | 20 | Authorization Number | 951523387713 |
instmntType Required | N | 2 | 2 | |
instmntMon Required | N | 2 | Installment Month 1: 1 Month/Full Payment, jika instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months | 1 |
mRefNo Required | AN | 18 | Reference Number | 202503071335234 |
matchCl Required | N | 1 | Payment Flag: Notification Match Amount Indicator | 1 |
status Required | A | 1 | 0 |
Merchant harus melakukan perbandingan kembali terhadap setiap Merchant Token yang diterima dari Notification 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 Direct Debit Notification
merchantToken=ecd49958d29595d09cd7ccab6057e9db119dfeb83676c27fb7649d3393b911aa
goodsNm=John Doe
referenceNo=ORD20250307130386
transTm=133600
tXid=TNICECP04104202503071335233256
amt=10000
receiptCode=951523387713
instmntType=2
billingNm=John Doe
matchCl=1
mRefNo=202503071335234
payMethod=04
currency=IDR
instmntMon=1
transDt=20250307
status=0