NICEPAY Inquiry Virtual Account
Integrasi NICEPAY Inquiry Virtual Account digunakan untuk metode pembayaran Virtual Account tipe NICEPAY Inquiry Virtual Account. Pada metode pembayaran ini, data Pelanggan berada di sisi Merchant. Sehingga, pada setiap pembayaran dari Bank, NICEPAY membutuhkan inquiry data Pelanggan, konfirmasi pembayaran, dan melakukan request pembayaran ke Merchant.
![Flow NICEPAY Inquiry Virtual Account Flow NICEPAY Inquiry Virtual Account](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/OJT2u3IojTYOzGRGOaDFd_payment-va-bulk.png?format=webp)
Proses ini bertujuan untuk mengetahui rincian tagihan. Setelah NICEPAY mendapatkan permintaan inquiry dari Bank, NICEPAY akan menggunakan Merchant service untuk mendapatkan informasi rincian data Pelanggan. Kemudian, data tersebut akan tersimpan dalam riwayat internal sistem NICEPAY dan akan dikirim ke Bank menggunakan format response Bank inquiry.
API URL | https:// < merchant URL for inquiry > |
Request Method | POST (Body Raw JSON) |
Merchant Token | - |
Request Format | - |
Berikut ini adalah daftar parameter untuk melakukan proses Inquiry NICEPAY kepada Merchant dari transaksi yang dilakukan pada metode pembayaran Virtual Account tipe NICEPAY Inquiry Virtual Account. Parameter ini digunakan melalui platform pengujian API sebagai salah satu tahapan supaya sistem milik Merchant dapat terhubung dengan layanan dari NICEPAY.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
customerId | N | 9 | Customer ID | 891011101 |
merchantToken | AN | 255 | SHA256 (Merchant ID + Customer ID + Merchant Key) | 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b |
prefix | N | 7 | Virtual Account Prefix Number | 7015102 |
bankCd | AN | 4 | "CENA |
Berikut adalah response parameter dari hasil request parameter untuk proses Inquiry NICEPAY kepada Merchant.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
billingNm | N | 100 | Customer Name | John Do |
goodsNm | AN | 100 | Goods/Item Name | Testing Buying |
referenceNo | N | 40 | Reference Number for Payment | ordNo20221130101148 |
amt | AN | 12 | Total Bill Amount | 5000 Normal Amount Only |
resultCd | N | 4 | Result Code of Inquiry Status | 0000 |
resultMsg | AN | 255 | Result Message for the Result Code | SUCCESS |
Payment Process NICEPAY to Merchant adalah tahap untuk melanjutkan proses pembayaran yang dilakukan Pelanggan. Saat Bank melakukan payment request ke NICEPAY menggunakan nomor Virtual Account, NICEPAY akan memanggil Merchant payment URL service untuk proses pembayaran. Merchant menentukan response payment untuk menerima atau menolak pembayaran dari Pelanggan.
API End Point | https:// < merchant URL for payment > |
Method | POST (Body Raw JSON) |
Berikut ini adalah daftar parameter untuk melakukan Payment Process NICEPAY to Merchant dari transaksi yang dilakukan pada metode pembayaran Virtual Account tipe NICEPAY Inquiry Virtual Account. Parameter ini digunakan melalui platform pengujian API sebagai salah satu tahapan supaya sistem milik Merchant dapat terhubung dengan layanan dari NICEPAY.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
customerId | N | 9 | Customer ID | 110000001 |
merchantToken | AN | 255 | SHA256 (Merchant ID + Customer ID + amt + Merchant Key) | 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b |
referenceNo | AN | 40 | Reference Number from Inquiry | OrdNo202210102323223 |
prefix | N | 7 | Virtual Account Prefix Number | 7015102 |
bankCd | AN | 4 | CENA | |
amt | N | 12 | Total Bill Amount | 10000 |
tXid | AN | 30 | Transaction ID from NICEPAY | NORMALTEST02202211301010513135 |
Berikut adalah response parameter dari hasil request parameter untuk Payment Process NICEPAY to Merchant.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
billingNm | N | 100 | Customer Name | John Doe |
goodsNm | AN | 255 | Goods/Item Name | Testing Buying |
referenceNo | N | 7 | Reference Number for Payment | ordNo2022113010114 |
amt | AN | 4 | Total Bill Amount | Normal amount only |
resultCd | | 4 | Result Code of Inquiry Status | 0000 |
resultMsg | AN | 255 | Result Message for the Result Code | SUCCESS |
Reversal Process NICEPAY to Merchant adalah proses pengembalian dana yang terjadi akibat terjadi isu di dalam internal sistem Bank. Pada proses ini, NICEPAY akan melanjutkan informasi status yang didapat dari Bank kepada Merchant.
API End Point | https:// < merchant URL for reversal> |
Method | POST (Body Raw JSON) |
![Proses Reversal VA Proses Reversal VA](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/Szs-r5qOWImlRGewe9dRb_nicepay-archbee-payment-va-reversaldrawio-4.png?format=webp)
Berikut ini adalah daftar parameter untuk melakukan Reversal Process NICEPAY to Merchant dari transaksi yang dilakukan pada metode pembayaran Virtual Account tipe NICEPAY Inquiry Virtual Account. Parameter ini digunakan melalui platform pengujian API sebagai salah satu tahapan supaya sistem milik Merchant dapat terhubung dengan layanan dari NICEPAY.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
customerId | N | 9 | Customer ID | 110000001 |
merchantToken | AN | 255 | SHA256 (Merchant ID + Customer ID + amt + Merchant Key) | 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b |
referenceNo | AN | 40 | Reference Number from Inquiry | OrdNo202210102323223 |
prefix | N | 7 | Virtual Account Prefix Number | 7015102 |
bankCd | AN | 4 | CENA | |
amt | N | 12 | Total Bill Amount | 10000 |
tXid | AN | 30 | Transaction ID from NICEPAY | NORMALTEST02202211301010513135 |
Berikut adalah response parameter dari hasil request parameter untuk Reversal Process NICEPAY to Merchant.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
billingNm | N | 100 | Customer Name | John Doe Topup amount only |
goodsNm | AN | 100 | Goods/Item Name | Testing Reversal Transaction Topup amount only |
referenceNo | N | 40 | Reference Number for Payment | OrdNo202210102323223 |
amt | AN | 12 | Total Bill Amount | 50000 |
resultCd | | 34 | Result Code of Inquiry Status Result Code | 0000 |
resultMsg | | 255 | Result Message for the Result Code | SUCCESS |
Kunjungi halaman Status Inquiry - API Checkout untuk mengetahui API untuk memeriksa status inquiry khusus Checkout.
Kunjungi halaman Cancel - API Checkout untuk mengetahui API untuk membatalkan transaksi khusus Checkout.
Kunnjungi halaman Status Inquiry - API Virtual Account untuk mengetahui API virtual account untuk memeriksa status inquiry pada API khusus Payment.
Kunjungi halaman Cancel - API Virtual Account untuk mengetahui API virtual account untuk membatalkan transaksi pada API khusus Payment.