NICEPAY API
...
API GPN
Notification - API GPN
7 min
tentang api gpn notification mengirimkan push notification dikirim melalui dbprocessurl harus memastikan tidak melakukan blacklist ip dan melakukan whitelist ip untuk mendapatkan push notification hanya dikirim dari server request method post post merchant token sha256 ( imid + txid + amt + merchantkey ) ip ip public environtment production 103 20 51 34 103 20 51 33 ip public environtment dev 103 20 51 39 103 20 51 40 user agent user agent jakarta commons httpclient/3 1 notification parameter gpn notification ketika diterima pada dbprocessurl , kami sangat menyarankan untuk melakukan verifikasi kembali dengan menggunakan docid\ zir5hzgz6qsfbwjhgmolz parameter tipe ukuran deskripsi contoh / catatan cctranstype n 2 docid 5kylpx5mpjsl96c8mhoik 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 docid\ ky4ppujot06atnie easf othr when success, cc matchcl n 1 flag ( docid wbzuzhpbdoycdehlbbx9 ) 1 preauthtoken an 64 pre auth token null cardexpyymm n 4 card expiry ( yymm ) 3112 acqubanknm a 255 acquiring name bni paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 09 currency a 3 currency idr instmntmon required for cc required for cc n 2 installment month 1 issubanknm a 255 issuing name mandiri merchanttoken an 255 token 8fe18983b08405e3b2185135b575e87b92ffdb68e8cc603c72d2ec2062129823 goodsnm an 100 goods name 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 docid\ rt2c32s9hfl aohyoebv5 2 billingnm a 100 buyer name buyer name john+doe acqubankcd a 4 docid\ ky4ppujot06atnie easf bnin transdt n 8 transaction date ( yyyymmdd ) 20221214 status a 1 deposit status docid\ ucni27ufonck8 zttm mv 0 deposit 1 reversal 0 additional parameter for others payment method notification parameter tipe ukuran deskripsi mitracd a 4 docid\ tm257gq3dxgzf98uz0l33 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 ) merchant token diterima dari notification , harus melakukan perbandingan kembali secara internal untuk mencegah palsu/tidak berlaku 💡contoh kasus misalnya, memiliki merchantkey digunakan untuk melakukan generate token, yaitu 1234 ketika merchanttoken di generate diketahui adalah abcd , sementara merchanttoken didapatkan pada adalah abdd , maka tersebut dianggap palsu/tidak berlaku 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