NICEPAY API
...
Checkout API
Notification - API Checkout
9 min
about api checkout notification sends push through 's dbprocessurl the needs to reassure there is no blacklist ip and should whitelist ip to get push only from 's server api checkout notification method 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 parameter type size description example / notes txid n 30 transaction id merchanttoken an 255 token referenceno ans 40 order number paymethod n 2 docid\ ek 0djw7nuhytcda4sa3p amt n 12 amount transdt n 8 transaction date transtm n 6 transaction time currency a 3 currency goodsnm an 100 goods name billingnm a 100 billing name matchcl n 1 amount match flag docid yqqe4ju5bjurdxkxdtho status a 1 deposit status docid\ qahrf3q4g85njtqxmwfyk 0 deposit 1 reversal when is received to your dbprocessurl , strongly recommend to verify again by using docid 7thqvphz6emwezw5 d4an additional parameter for credit card notification parameter type size description example / notes authno n 10 approval number issuebankcd a 4 docid\ qbeq29lj53z vbvxtvb7l issuebanknm a 255 issuing name acqubankcd a 4 docid\ qbeq29lj53z vbvxtvb7l acqubanknm a 255 acquiring name cardno ans 20 card number with masking cardexpyymm n 4 card expiration ( yymm ) instmntmon n 2 installment month 1 1 month/full , if instmnttype null/1 3 3 months 6 6 months 12 12 months instmnttype n 2 docid\ wfsinjxqc2s9yubbybpep preauthtoken an 255 pre auth token recurringtoken an 255 recurring token cctranstype a 2 docid 7pas vd5ylg4vdurmygwo 1 normal 2 recurring 3 pre auth 4 captured vat n 12 number fee n 12 service fee notaxamt n 12 tax free amount additional parameter for virtual account notification parameter type size description example / notes bankcd a 4 docid\ qbeq29lj53z vbvxtvb7l vacctno n 16 va number vacctvaliddt n 8 va expiry date ( yyyymmdd ) vacctvalidtm n 6 va expiry time ( hh24miss ) depositdt n 8 deposit date ( yyyymmdd ) deposittm n 6 deposit time ( hh24miss ) additional parameter for others payment method notification parameter type size description example / notes mitracd a 4 docid 0upx1lyg1o2f4biu3ssp payno n 12 number payvaliddt n 8 expiry date ( yyyymmdd ) payvalidtm n 6 expiry time ( hh24miss ) receiptcode ans 20 authorization number mrefno an 18 reference number depositdt n 8 deposit date ( yyyymmdd ) deposittm n 6 deposit time ( hh24miss ) token that received from notification, must do internally re compared to prevent invalid/fake sample for notification parameter sample post for notification txid={txid} referenceno={referenceno} amt={amt} merchanttoken={merchanttoken} matchcl={matchcl} status={status} bankcd={bankcd} vacctno={vacctno} authno={authno} cardno={cardno} issubankcd = {issubankcd} issubanknm = {issubanknm} acqubankcd = {acqubankcd} acqubanknm = {acqubanknm} depositdt = {depositdt} deposittm = {deposittm} payno={payno}