NICEPAY API
...
API Convenience Store
Notification - API Convenience Store
6 min
about api convenience store notification provides push s via dbprocessurl 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 convenience store when your dbprocessurl received a , strongly recommend to verify using docid 79r7v9ynenetfidqqvmkk parameter type size description example / notes txid n 30 transaction id tnicecv03103202212141459041632 merchanttoken an 255 token 8b5565e793731a1a1c8817c9e42bcbbdc3f5fb6a2785a6e0b19a2d5e3a41a51b referenceno ans 40 order number ord0123456 mitracd a 4 docid 0upx1lyg1o2f4biu3ssp alma paymethod n 2 docid\ ek 0djw7nuhytcda4sa3p 04 payno n 20 number 504100002539 payvalidtm n 6 cvs expiry time ( hh24miss ) null payvaliddt n 8 cvs expiry date ( yyyymmdd ) (cvs) null amt n 12 amount 5000 clientuserkey mandatory if tokenize mandatory if tokenize an 100 user key, must be unique for each 1134431 usertoken ans user token 12345eea9 6234 6789 12r3 123re3456tt5 tokenizeuser n 1 transaction tokenize type 1 transdt n 8 transaction date 20221214 transtm n 6 transaction time 150229 currency a 3 currency idr goodsnm an 100 goods name testing billingnm a 100 billing name john doe matchcl n 1 flag docid yqqe4ju5bjurdxkxdtho 1 status a 1 deposit status docid\ qahrf3q4g85njtqxmwfyk 0 deposit 1 reversal 0 instmnttype n 2 docid\ wfsinjxqc2s9yubbybpep 1 instmntmon n 2 installment month 1 the token received by notification endpoint must compare 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 convenience store notification sample post for convenience store notification merchanttoken=8b5565e793731a1a1c8817c9e42bcbbdc3f5fb6a2785a6e0b19a2d5e3a41a51b goodsnm=testing referenceno=ord0123456 mitracd=alma transtm=150229 txid=tnicecv03103202212141459041632 amt=5000 instmnttype=1 billingnm=john doe matchcl=1 payno=504100002539 payvalidtm=null paymethod=03 currency=idr instmntmon=1 payvaliddt=null transdt=20221214 status=0