NICEPAY API
...
Payment API
API GPN
Notification - API GPN
7 min
tentang api gpn notification {{nicepay}} mengirimkan push notification {{yang}} dikirim melalui dbprocessurl {{merchant}} {{merchant}} harus memastikan tidak melakukan blacklist ip {{nicepay}} dan melakukan whitelist ip {{nicepay}} untuk mendapatkan push notification {{yang}} hanya dikirim dari server {{nicepay}} 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 ketika {{notifikasi}} diterima pada dbprocessurl {{anda}} , kami sangat menyarankan {{merchant}} untuk melakukan verifikasi {{notifikasi}} kembali dengan menggunakan status inquiry api gpn docid\ zir5hzgz6qsfbwjhgmolz parameter tipe ukuran deskripsi contoh / catatan cctranstype n 2 payment status code 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 {{paymentproduct}} amount 15000 notaxamt n 12 tax free amount 0 cardno n 20 card number 41111111 1111 issubankcd a 4 bank code docid\ ky4ppujot06atnie easf othr when success, cc matchcl n 1 {{paymentproduct}} flag ( notification match amount indicator docid wbzuzhpbdoycdehlbbx9 ) 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\ iifmsruuw7j9vmwefjz97 09 currency a 3 currency idr instmntmon required for cc required for cc n 2 installment month 1 issubanknm a 255 issuing {{bank}} name mandiri merchanttoken an 255 {{merchant}} token 8fe18983b08405e3b2185135b575e87b92ffdb68e8cc603c72d2ec2062129823 goodsnm an 100 goods name 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\ rt2c32s9hfl aohyoebv5 2 billingnm a 100 buyer name buyer name john+doe acqubankcd a 4 bank code docid\ ky4ppujot06atnie easf bnin transdt n 8 transaction date ( yyyymmdd ) 20221214 status a 1 deposit status notification status code docid\ ucni27ufonck8 zttm mv 0 deposit 1 reversal 0 additional parameter for others payment method notification parameter tipe ukuran deskripsi mitracd a 4 mitra code docid\ tm257gq3dxgzf98uz0l33 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 ) merchant token {{yang}} diterima dari notification , {{merchant}} harus melakukan perbandingan kembali secara internal untuk mencegah {{notifikasi}} palsu/tidak berlaku 💡contoh kasus misalnya, {{anda}} memiliki merchantkey {{yang}} digunakan untuk melakukan generate token, yaitu 1234 ketika merchanttoken {{yang}} di generate {{merchant}} diketahui adalah abcd , sementara merchanttoken {{yang}} didapatkan pada {{notifikasi}} adalah abdd , maka {{notifikasi}} 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