Notification - API Direct Debit
6 min
about api direct debit notification will send push s via the dbprocessurl based on provided in docid 8j0pu1u2uvg7uzuknzzkf the needs to reassure there is no blacklist ip and should whitelist ip to get push only from 's 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 when your dbprocessurl received a , strongly recommend to verify using docid\ b6ctfh0si5ntzuljbwtnd parameter type length description example / notes 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 , 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 flag docid wbzuzhpbdoycdehlbbx9 1 status required required a 1 deposit status docid\ ucni27ufonck8 zttm mv 0 deposit 1 reversal 0 must compare again every token received by notification internally to prevent fake/invalid s 💡example case for example, you have a merchantkey that is used to generate a token, which is 1234 when merchanttoken generated by is known, it is abcd , while merchanttoken obtained in is abdd then 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