NICEPAY API
API Version 1 (V1)
V1 Notification
9 min
about notification provides real time push notification through 's dbprocessurl to avoid notification blocked by 's firewall, please add these 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 to verify notification by using docid\ b hqvi5gbns yxcexem2a parameter type size description txid n 30 transaction id merchanttoken an 255 token referenceno ans 40 order number paymethod n 2 docid logd 07e0vrfugu0nldf 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 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 name acqubankcd a 4 docid logd 07e0vrfugu0nldf acqubanknm a 255 acquiring 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 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 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 number userid an 128 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 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 token received by your notification endpoint should be compared internally to prevent fake notifications