Notification - API Checkout

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 payment method code 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 notification match amount indicator docid wbzuzhpbdoycdehlbbx9 status a 1 deposit status notification status code docid\ ucni27ufonck8 zttm mv 0 deposit 1 reversal ketika diterima pada dbprocessurl , kami sangat menyarankan untuk melakukan verifikasi kembali dengan menggunakan status inquiry api checkout docid\ tsmzvn ulka6hnmbkk5wl additional parameter for credit card notification parameter tipe ukuran deskripsi contoh / catatan authno n 10 approval number issuebankcd a 4 issuing bank code docid\ ky4ppujot06atnie easf issuebanknm a 255 issuing name acqubankcd a 4 acquiring bank code 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 installment type code 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 bank code 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 mitra code 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