NICEPAY API
...
Checkout API
Notification - API Checkout
9 min
about api checkout notification {{nicepay}} sends push {{notification}} through {{merchant}} 's dbprocessurl 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 api checkout notification method 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 parameter type size description example / notes txid n 30 transaction id merchanttoken an 255 {{merchant}} token referenceno ans 40 {{merchant}} order number paymethod n 2 docid\ ek 0djw7nuhytcda4sa3p amt n 12 {{paymentproduct}} 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 {{paymentproduct}} amount match flag docid yqqe4ju5bjurdxkxdtho status a 1 deposit status docid\ qahrf3q4g85njtqxmwfyk 0 deposit 1 reversal when {{notification}} is received to your dbprocessurl , {{nicepay}} strongly recommend {{merchant}} to verify {{the}} {{notification}} 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 {{bank}} name acqubankcd a 4 docid\ qbeq29lj53z vbvxtvb7l acqubanknm a 255 acquiring {{bank}} name cardno ans 20 card number with masking cardexpyymm n 4 card expiration ( yymm ) instmntmon n 2 installment month 1 1 month/full {{paymentproduct}} , 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 {{vat}} 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 {{bank}} 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 {{paymentproduct}} 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 ) {{merchant}} token that received from notification, {{merchant}} must do internally re compared to prevent {{the}} invalid/fake {{notification}} 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}