Notification - API GPN
7 min
about api gpn notification provides push s via dbprocessurl the needs to reassure there is no blacklist ip and should whitelist ip to get push only from 's server request method \<font color="#3b9f0f"> post \</font> merchant token sha256 ( imid + txid + amt + merchantkey ) ip ip public environtment production 103 20 51 34 103 20 51 33 18 98 96 50 ip public environtment dev 103 20 51 39 103 20 51 40 18 98 96 54 user agent user agent jakarta commons httpclient/3 1 notification parameter gpn notification when your dbprocessurl received a , strongly encourage s to verify using status inquiry api gpn docid\ uh cipwwjjwzg03pc4 el parameter type size description example / notes cctranstype n 2 credit card transaction type 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 amount 15000 notaxamt n 12 tax free amount 0 cardno n 20 card number 41111111 1111 issubankcd a 4 issuing bank code docid\ hlxvgrxvxwd90n8ohnkm0 othr when success, cc matchcl n 1 flag ( notification match amount indicator docid\ hhezyw5ikliptkqyya5bi ) 1 preauthtoken an 64 pre auth token null cardexpyymm n 4 card expiry ( yymm ) 3112 acqubanknm a 255 acquiring name bni paymethod n 2 payment method code docid\ nq1y7vma25ztvqhn5he6w 09 currency a 3 currency idr instmntmon \<font color="#2166ae">required for cc\</font> n 2 installment month required for cc 1 issubanknm a 255 issuing name mandiri merchanttoken an 255 token 8fe18983b08405e3b2185135b575e87b92ffdb68e8cc603c72d2ec2062129823 goodsnm an 100 goods name payment+of+invoice+no+20221214132651 referenceno ans 40 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 0 when success, cc instmnttype n 2 installment type code docid wzur5wjwhrdr8yxi ppi 2 billingnm a 100 buyer name john+doe acqubankcd a 4 acquiring bank code docid\ hlxvgrxvxwd90n8ohnkm0 bnin transdt n 8 transaction date ( yyyymmdd ) 20221214 status a 1 deposit status notification status code docid\ qumt9fmvjdh5gjhd2pwy8 0 deposit 1 reversal 0 additional parameter for others payment method notification parameter type size description mitracd a 4 mitra code docid 0lup35kfowksisrzkx6yz 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 ) the token received by notification endpoint must compare internally to prevent fake/invalid s 💡example case for example, you have a merchantkey that is used to generate a token, which is 1234 when merchanttoken generated by is known, it is abcd , while merchanttoken obtained in is abdd then 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