Notification - API GPN

about api gpn notification {{nicepay}} provides push {{notification}} s via dbprocessurl {{merchant}} 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 request method post 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 gpn notification when your dbprocessurl received a {{notification}} , {{nicepay}} strongly encourage {{merchant}} s to verify {{the}} {{notification}} using {{the}} status inquiry api gpn docid\ z6mz313pnsr5weunylyta parameter type size description example / notes cctranstype n 2 payment status code docid 7pas vd5ylg4vdurmygwo 1 normal 2 recurring 3 pre auth 4 capture when success fee n 12 service fee 0 when success, cc txid an 30 transaction id ionpaytest01202212141326511512 amt n 12 {{paymentproduct}} amount 15000 notaxamt n 12 tax free amount 0 cardno n 20 card number 41111111 1111 issubankcd a 4 bank code docid\ qbeq29lj53z vbvxtvb7l othr when success, cc matchcl n 1 {{paymentproduct}} flag ( notification match amount indicator docid yqqe4ju5bjurdxkxdtho ) 1 preauthtoken an 64 pre auth token null cardexpyymm n 4 card expiry ( yymm ) 3112 acqubanknm a 255 acquiring {{bank}} name bni paymethod n 2 payment method code docid\ ek 0djw7nuhytcda4sa3p 09 currency a 3 currency idr instmntmon required for cc required for cc n 2 installment month required for cc 1 issubanknm a 255 issuing {{bank}} name mandiri merchanttoken an 255 {{merchant}} token 8fe18983b08405e3b2185135b575e87b92ffdb68e8cc603c72d2ec2062129823 goodsnm an 100 goods name payment+of+invoice+no+20221214132651 referenceno ans 40 {{merchant}} reference number 20221214132651 authno n 10 approval number 511512 transtm n 6 transaction time ( hh24miss ) 132651 cpguaranteeablestatus n 4 status guaranteeable null recurringtoken an 64 recurring token null vat n 12 {{vat}} 0 when success, cc instmnttype n 2 installment type code docid\ wfsinjxqc2s9yubbybpep 2 billingnm a 100 buyer name john+doe acqubankcd a 4 bank code docid\ qbeq29lj53z vbvxtvb7l bnin transdt n 8 transaction date ( yyyymmdd ) 20221214 status a 1 deposit status notification status code docid\ qahrf3q4g85njtqxmwfyk 0 deposit 1 reversal 0 additional parameter for others payment method notification parameter type size description mitracd a 4 mitra code 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 ) the {{merchant}} token received by {{the}} notification endpoint must compare internally to prevent fake/invalid {{notification}} s 💡example case for example, you have a merchantkey that is used to generate a token, which is 1234 when {{the}} merchanttoken generated by {{the}} {{merchant}} is known, it is abcd , while {{the}} merchanttoken obtained in {{the}} {{notification}} is abdd then {{the}} {{notification}} is considered fake/invalid sample for gpn notification sample post for gpn notification cctranstype = 1 fee = 0 txid = ionpaytest01202212141326511512 amt = 15000 notaxamt = 0 cardno = 41111111 1111 issubankcd = othr matchcl = 1 preauthtoken = null cardexpyymm = 3112 acqubanknm = bni paymethod = 09 currency = idr instmntmon = 1 cc trans type = 1 issubanknm = mandiri merchanttoken = 8fe18983b08405e3b2185135b575e87b92ffdb68e8cc603c72d2ec2062129823 goodsnm = payment+of+invoice+no+20221214132651 referenceno = 20221214132651 authno = 511512 transtm = 132651 cpguaranteeablestatus = null recurringtoken = null vat = 0 instmnttype = 2 billingnm = john+doe acqubankcd = bnin transdt = 20221214 status = 0