NICEPAY API
...
API Direct Debit
Notification - API Direct Debit
6 min
about api direct debit notification {{nicepay}} will send push {{notification}} s via the dbprocessurl {{parameter}} based on {{the}} {{merchant}} {{information}} provided in {{the}} docid 8j0pu1u2uvg7uzuknzzkf the {{merchant}} needs to reassure there is no blacklist {{nicepay}} ip and should whitelist {{nicepay}} ip to get {{the}} push {{notification}} only from {{nicepay}} 's server request method post 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 direct debit notification when your dbprocessurl received a {{notification}} , {{nicepay}} strongly recommend {{merchant}} to verify {{the}} {{notification}} using {{the}} docid\ b6ctfh0si5ntzuljbwtnd parameter type length description example / notes txid required required n 30 transaction id tnicecp04100202210201205567417 merchanttoken required required an 255 {{merchant}} token ecd49958d29595d09cd7ccab6057e9db119dfeb83676c27fb7649d3393b911aa referenceno required required ans 40 {{merchant}} order number ord20250307130386 mitracd required required a 4 docid\ tm257gq3dxgzf98uz0l33 jenc paymethod required required n 2 docid\ iifmsruuw7j9vmwefjz97 04 payno optional optional n 20 {{paymentproduct}} 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 {{paymentproduct}} amount 10000 clientuserkey mandatory if tokenize mandatory if tokenize an 100 user key, must be unique for each {{customer}} 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 {{paymentproduct}} , if 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 {{paymentproduct}} flag docid wbzuzhpbdoycdehlbbx9 1 status required required a 1 deposit status docid\ ucni27ufonck8 zttm mv 0 deposit 1 reversal 0 {{merchant}} must compare again every {{merchant}} token received by {{the}} notification internally to prevent fake/invalid {{notification}} s 💡example case for example, you have a merchantkey that is used to generate a token, which is 1234 when {{the}} merchanttoken generated by {{the}} {{merchant}} is known, it is abcd , while {{the}} merchanttoken obtained in {{the}} {{notification}} is abdd then {{the}} {{notification}} is considered fake/invalid 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