Notification - API Virtual Account
mengirimkan push notification dikirim melalui dbProcessUrl . harus memastikan tidak melakukan Blacklist IP dan melakukan Whitelist IP untuk mendapatkan push notification hanya dikirim dari server .
Request 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 |
Ketika diterima pada dbProcessUrl , kami sangat menyarankan untuk melakukan verifikasi kembali dengan menggunakan Status Inquiry - API Virtual Account.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
|---|---|---|---|---|
tXid | N | 30 | Transaction ID | IONPAYTEST02202212141423372834 |
merchantToken | AN | 255 | Token | 76a7ea699351eef2ffd1ade233547ed7f3b44aea5859aee7c2250bff1bae7dc9 |
referenceNo | ANS | 40 | Order Number | order123 |
payMethod | N | 2 | | |
amt | N | 12 | Amount | 10000 |
vacctNo | N | 20 | VA Number | 70014000091423372834 |
transTm | N | 6 | Transaction Time | 142527 |
transDt | N | 8 | Transaction Date | 20221214 |
instmntType | N | 2 | 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 | Name |
status | A | 1 | 0 | |
matchCl | N | 1 | Flag: Notification Match Amount Indicator | 1 |
Parameter | Tipe | Ukuran | Deskripsi |
|---|---|---|---|
bankCd | A | 4 | |
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) |
Merchant Token diterima dari Notification, harus melakukan perbandingan kembali secara internal untuk mencegah palsu/tidak berlaku.
💡Contoh Kasus:
Misalnya, memiliki merchantKey digunakan untuk melakukan generate token, yaitu 1234. Ketika merchantToken di-generate diketahui adalah abcd, sementara merchantToken didapatkan pada adalah abdd, maka tersebut dianggap palsu/tidak berlaku.
⚠️ Perhatikan mengenai reversal process dapat terjadi pada . Untuk reversal pada , akan otomatis terkirim dari ke sebagai gagal . akan meneruskan mengenai reversal process ke untuk ditangani lebih lanjut oleh sebagai update menjadi failed/cancel. pelajari lebih lanjut mengenai Penyelesaian Transaksi Pada VA.