Notification - API Virtual Account
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 |
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 notifikasi diterima pada dbProcessUrl Anda, kami sangat menyarankan Merchant untuk melakukan verifikasi notifikasi kembali dengan menggunakan Status Inquiry - API Virtual Account.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
tXid | N | 30 | Transaction ID | IONPAYTEST02202212141423372834 |
merchantToken | AN | 255 | Merchant Token | 76a7ea699351eef2ffd1ade233547ed7f3b44aea5859aee7c2250bff1bae7dc9 |
referenceNo | ANS | 40 | Merchant Order No. | order123 |
payMethod | N | 2 | | |
amt | N | 12 | Payment 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 | Customer Name |
status | A | 1 | 0 | |
matchCl | N | 1 | Payment Flag: Notification Match Amount Indicator | 1 |
Parameter | Tipe | Ukuran | Deskripsi |
bankCd | A | 4 | |
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 Virtual Account. Untuk status reversal pada Virtual Account, 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 Penyelesaian Transaksi Pada VA.