NICEPAY API
...
API Virtual Account
Notification - API Virtual Account
8 min
tentang api virtual account 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 virtual account ketika {{notifikasi}} diterima pada dbprocessurl {{anda}} , kami sangat menyarankan {{merchant}} untuk melakukan verifikasi {{notifikasi}} kembali dengan menggunakan docid\ gqrexfrfyfx9ofueguap4 parameter tipe ukuran deskripsi contoh / catatan txid n 30 transaction id ionpaytest02202212141423372834 merchanttoken an 255 {{merchant}} token 76a7ea699351eef2ffd1ade233547ed7f3b44aea5859aee7c2250bff1bae7dc9 referenceno ans 40 {{merchant}} order number order123 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 amt n 12 {{paymentproduct}} amount 10000 vacctno n 20 va number 70014000091423372834 transtm n 6 transaction time 142527 transdt n 8 transaction date 20221214 instmnttype n 2 docid\ rt2c32s9hfl aohyoebv5 1 instmntmon n 2 installment month null vacctvalidtm n 6 va expiry time ( hh24miss ) 142337 vacctvaliddt n 8 va expiry date ( yyyymmdd ) 20221216 currency a 3 currency goodsnm an 100 goods name test+transaction+nicepay billingnm a 100 billing name {{customer}} name status a 1 deposit status docid\ ucni27ufonck8 zttm mv 0 deposit 1 reversal 0 matchcl n 1 {{paymentproduct}} flag docid wbzuzhpbdoycdehlbbx9 1 additional parameter for virtual account notification parameter tipe ukuran deskripsi 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 ) 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 ⚠️ perhatikan mengenai reversal process {{yang}} dapat terjadi pada {{va}} untuk {{status}} reversal pada {{va}} , {{notifikasi}} akan otomatis terkirim dari {{bank}} ke {{pelanggan}} sebagai gagal {{transaksi}} {{nicepay}} akan meneruskan {{notifikasi}} mengenai reversal process ke {{merchant}} untuk ditangani lebih lanjut oleh {{merchant}} sebagai update {{status}} menjadi failed/cancel {{silakan}} pelajari lebih lanjut mengenai docid 0olvbjow31mompjerhuot sample for va notification sample post for va notification merchanttoken = 76a7ea699351eef2ffd1ade233547ed7f3b44aea5859aee7c2250bff1bae7dc9 goodsnm = test+transaction+nicepay referenceno = order123 transtm = 142527 txid = ionpaytest02202212141423372834 amt = 10000 vacctno = 70014000091423372834 instmnttype = 1 billingnm = customer+name matchcl = 1 vacctvaliddt = 20221216 paymethod = 02 bankcd = bmri currency = idr instmntmon = null vacctvalidtm = 142337 transdt = 20221214 status = 0