NICEPAY API
...
Checkout API
Notification - API Checkout
11 min
tentang notification api checkout {{nicepay}} mengirimkan push notification 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}} notification api checkout method 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 for notification api checkout parameter tipe ukuran deskripsi contoh / catatan txid n 30 transaction id merchanttoken an 255 {{merchant}} token referenceno ans 40 {{merchant}} order number paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 amt n 12 {{paymentproduct}} amount transdt n 8 transaction date transtm n 6 transaction time currency a 3 currency goodsnm an 100 goods name billingnm a 100 billing name matchcl n 1 {{paymentproduct}} amount match flag docid wbzuzhpbdoycdehlbbx9 status a 1 deposit status docid\ ucni27ufonck8 zttm mv 0 deposit 1 reversal ketika {{notifikasi}} diterima pada dbprocessurl {{anda}} , kami sangat menyarankan {{merchant}} untuk melakukan verifikasi {{notifikasi}} kembali dengan menggunakan docid\ tsmzvn ulka6hnmbkk5wl additional parameter for credit card notification parameter tipe ukuran deskripsi contoh / catatan authno n 10 approval number issuebankcd a 4 docid\ ky4ppujot06atnie easf issuebanknm a 255 issuing {{bank}} name acqubankcd a 4 docid\ ky4ppujot06atnie easf acqubanknm a 255 acquiring {{bank}} name cardno ans 20 card number with masking cardexpyymm n 4 card expiration ( yymm ) instmntmon n 2 installment month 1 1 month/full {{paymentproduct}} , jika instmnttype null/1 3 3 months 6 6 months 12 12 months instmnttype n 2 docid\ rt2c32s9hfl aohyoebv5 preauthtoken an 255 pre auth token recurringtoken an 255 recurring token cctranstype a 2 {{cc}} transaction type 1 normal 2 recurring 3 pre auth 4 captured vat n 12 {{vat}} number fee n 12 service fee notaxamt n 12 tax free amount additional parameter for virtual account notification parameter tipe ukuran deskripsi contoh / catatan bankcd a 4 docid\ ky4ppujot06atnie easf vacctno n 16 {{bank}} va number vacctvaliddt n 8 va expiry date ( yyyymmdd ) vacctvalidtm n 6 va expiry time ( hh24miss ) depositdt n 8 deposit date ( yyyymmdd ) deposittm n 6 deposit time ( hh24miss ) additional parameter for others payment method notification parameter tipe ukuran deskripsi contoh / catatan mitracd a 4 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 sample parameter for notification api checkout request parameter curl curl location 'https //www merchant dbprocessurl com' \\ \ header 'content type application/x www form urlencoded' \\ \ data urlencode 'cctranstype=1' \\ \ data urlencode 'fee=0' \\ \ data urlencode 'txid=testmpgs0401202510271659168614' \\ \ data urlencode 'amt=20' \\ \ data urlencode 'notaxamt=0' \\ \ data urlencode 'cardno=51234500 0008' \\ \ data urlencode 'issubankcd=btpn' \\ \ data urlencode 'matchcl=1' \\ \ data urlencode 'preauthtoken=null' \\ \ data urlencode 'cardexpyymm=3912' \\ \ data urlencode 'acqubanknm=cimb' \\ \ data urlencode 'paymethod=01' \\ \ data urlencode 'currency=idr' \\ \ data urlencode 'instmntmon=1' \\ \ data urlencode 'cc trans type=1' \\ \ data urlencode 'issubanknm=btpn' \\ \ data urlencode 'merchanttoken=8fb6a2b3748fea22590c58db8679d5b35e0781b33b1ad995823026fc0bcaa882' \\ \ data urlencode 'goodsnm=payment of reference no 382 20251027165916' \\ \ data urlencode 'referenceno=382 20251027165916' \\ \ data urlencode 'authno=320082' \\ \ data urlencode 'transtm=165916' \\ \ data urlencode 'cpguaranteeablestatus=null' \\ \ data urlencode 'recurringtoken=null' \\ \ data urlencode 'vat=0' \\ \ data urlencode 'instmnttype=1' \\ \ data urlencode 'billingnm=inka fazarillah' \\ \ data urlencode 'acqubankcd=bnia' \\ \ data urlencode 'transdt=20251027' \\ \ data urlencode 'status=0' response parameter sample response { "resultcd" "200", "resultmsg" "success", } // response is customizable, nicepay will read the http status code for success indicator