NICEPAY API
...
API Direct Debit
Notification - API Direct Debit
6 min
tentang api direct debit notification akan mengirimkan push notification melalui dbprocessurl sesuai dengan pada docid\ tb1k1cpn4vpzw3etvfugu harus memastikan tidak melakukan blacklist ip dan melakukan whitelist ip untuk mendapatkan push notification hanya dikirim dari server request method post post merchant token sha256 ( imid + txid + amt + merchantkey ) ip ip public environtment production 103 20 51 34 103 20 51 33 ip public environtment dev 103 20 51 39 103 20 51 40 user agent user agent jakarta commons httpclient/3 1 notification parameter direct debit notification ketika diterima pada dbprocessurl , kami sangat menyarankan untuk melakukan verifikasi kembali dengan menggunakan docid\ rbnsw oylchgzx9nqiujg parameter tipe ukuran deskripsi contoh / catatan txid required required n 30 transaction id tnicecp04100202210201205567417 merchanttoken required required an 255 token ecd49958d29595d09cd7ccab6057e9db119dfeb83676c27fb7649d3393b911aa referenceno required required ans 40 order number ord20250307130386 mitracd required required a 4 docid\ tm257gq3dxgzf98uz0l33 jenc paymethod required required n 2 docid\ iifmsruuw7j9vmwefjz97 04 payno optional optional n 20 number 504100002539 payvalidtm optional optional n 6 cvs expiry time ( hh24miss ) null payvaliddt optional optional n 8 expiry date ( yyyymmdd ) null amt required required n 12 amount 10000 clientuserkey mandatory if tokenize mandatory if tokenize an 100 user key, must be unique for each 1134431 usertoken optional optional ans 255 user token 12345eea9 6234 6789 12r3 123re3456tt5 tokenizeuser optional optional n 1 transaction tokenize type 1 transdt optional optional n 8 transaction date 20221020 transtm optional optional n 6 transaction time 120803 currency required required a 3 currency idr goodsnm required required an 100 goods name john doe billingnm required required a 100 billing name john doe receiptcode required required ans 20 authorization number 951523387713 instmnttype required required n 2 docid\ rt2c32s9hfl aohyoebv5 2 instmntmon required required n 2 installment month 1 1 month/full , jika instmnttype null/1 3 3 months 6 6 months 12 12 months 1 mrefno required required an 18 reference number 202503071335234 matchcl required required n 1 flag docid wbzuzhpbdoycdehlbbx9 1 status required required a 1 deposit status docid\ ucni27ufonck8 zttm mv 0 deposit 1 reversal 0 harus melakukan perbandingan kembali terhadap setiap token diterima dari notification 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 direct debit notification sample post 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