NICEPAY API
...
Checkout API
Notification - API Checkout
11 min
tentang notification api checkout mengirimkan push notification melalui dbprocessurl harus memastikan tidak melakukan blacklist ip dan melakukan whitelist ip untuk mendapatkan push notification hanya dikirim dari server notification api checkout method 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 for notification api checkout parameter tipe ukuran deskripsi contoh / catatan txid n 30 transaction id merchanttoken an 255 token referenceno ans 40 order number paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 amt n 12 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 amount match flag docid wbzuzhpbdoycdehlbbx9 status a 1 deposit status docid\ ucni27ufonck8 zttm mv 0 deposit 1 reversal ketika diterima pada dbprocessurl , kami sangat menyarankan untuk melakukan verifikasi 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 name acqubankcd a 4 docid\ ky4ppujot06atnie easf acqubanknm a 255 acquiring name cardno ans 20 card number with masking cardexpyymm n 4 card expiration ( yymm ) instmntmon n 2 installment month 1 1 month/full , 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 transaction type 1 normal 2 recurring 3 pre auth 4 captured vat n 12 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 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 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 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