NICEPAY API
API Version 1 (V1)
V1 Notification
9 min
about notification {{nicepay}} provides real time push notification through {{merchant}} 's dbprocessurl to avoid {{the}} notification blocked by {{merchant}} 's firewall, please add these {{nicepay}} server details to your firewall whitelist method merchant token ip user agent post application/x www form urlencoded application/x www form urlencoded sha256( imid + txid + amt + merchantkey ) 103 20 51 0/24 103 117 8 0/24 	 user agent jakarta commons httpclient/3 1 posst notifikasi dari nicepay 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} transdt = {depositdt} transtm = {deposittm} payno={payno} api notification when notification to your dbprocessurl is received, we strongly recommend {{merchant}} to verify {{the}} notification by using {{the}} docid\ b hqvi5gbns yxcexem2a parameter type size description txid n 30 transaction id merchanttoken an 255 {{merchant}} token referenceno ans 40 {{merchant}} order number paymethod n 2 docid logd 07e0vrfugu0nldf 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 30 billing name matchcl n 1 docid logd 07e0vrfugu0nldf status a 1 deposit status 0 deposit 1 reversal additional parameter for credit card notification parameter type size description authno n 10 approval number issuebankcd a 4 docid logd 07e0vrfugu0nldf issuebanknm a 255 issuing {{bank}} name acqubankcd a 4 docid logd 07e0vrfugu0nldf acqubanknm a 255 acquiring {{bank}} name cardno ans 20 card number with masking cardexpyymm n 4 card expiry ( yymm ) instmntmon n 2 installment month instmnttype n 2 docid logd 07e0vrfugu0nldf reauthtoken an 255 pre auth token recurringtoken an 255 recurring token cctranstype a 2 docid logd 07e0vrfugu0nldf 1 normal 2 recurring 3 pre uath 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 bankcd a 4 docid logd 07e0vrfugu0nldf vacctno n 16 {{bank}} va number vacctvaliddt n 8 va expired date ( yyyymmdd ) vacctvalidtm n 6 va expired time ( hh24miss ) additional parameter for qris notification parameter type size description paymenttrxsn an 32 transaction {{paymentproduct}} number userid an 128 {{qris}} user id hash shopid an 32 shop id additional parameter for others payment method notification parameter type size description mitracd a 4 docid logd 07e0vrfugu0nldf payno n 12 cvs {{paymentproduct}} number payvaliddt n 8 cvs expired date ( yyyymmdd ) payvalidtm n 6 cvs expired time ( hh24miss ) receiptcode ans 20 authorization number mrefno an 18 reference number {{merchant}} token received by your notification endpoint should be compared internally to prevent fake notifications