Virtual Account - API Checkout
API ini digunakan oleh Merchant untuk melakukan pengajuan pembayaran kepada NICEPAY dengan metode pembayaran Virtual Account menggunakan Checkout API.
Deskripsi langkah:
- Pelanggan melakukan checkout.
- Pelanggan mengirimkan data checkout kepada Merchant.
- Merchant melakukan pengajuan checkout menggunakan API Registration kepada NICEPAY.
- NICEPAY mengalihkan Merchant kepada halaman pembayaran.
- Merchant mengirimkan halaman pembayaran NICEPAY kepada Pelanggan.
- Pelanggan memilih metode pembayaran.
- Pelanggan membayar menggunakan VA kepada Bank.
- Bank melakukan proses pembayaran.
- Bank mengirimkan hasil pembayaran kepada Pelanggan.
- Bank mengirim notifikasi pembayaran kepada NICEPAY.
- NICEPAY memperbarui status pembayaran.
- NICEPAY mengirim notifikasi dbProcessUrl kepada Merchant.
- Merchant menerima status.
- Merchant mengajukan status inquiry kepada NICEPAY.
- NICEPAY menerima pengajuan.
- NICEPAY mengirimkan response status inquiry kepada Merchant.
- Merchant menerima status terakhir.
- Merchant mengirim halaman hasil transaksi kepada Pelanggan.
Silakan kunjungi halaman Panduan Bayar VA untuk dapat memberikan panduan pembayaran kepada Pelanggan Anda dalam metode Virtual Account.
Gambar di atas adalah contoh pembayaran dengan metode Virtual Account menggunakan NICEPAY Secure Payment Page.
Silakan arahkan Pelanggan Anda untuk memilih pilihan metode pembayaran ATM/Bank Transfer pada halaman pembayaran NICEPAY untuk dapat melakukan transaksi Virtual Account.
Setelah memilih metode dengan transfer Bank, Pelanggan Anda akan disediakan daftar Bank yang dapat dipilih untuk melanjutkan proses pembayaran.
API Checkout Transaction Payment untuk metode pembayaran Virtual Account digunakan untuk request registrasi dan pembayaran.
API URL | /nicepay/redirect/v2/payment |
|---|---|
Request Method | Redirect-GET |
Header | Content-Type: application/Form-UrlEncoded |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
|---|---|---|---|---|
paymentURL Required | ANS | 14 | Payment URL | https://dev.nicepay.co.id/nicepay/redirect/v2/payment |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST00202212231003086046 |
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
|---|---|---|---|---|
resultCd | N | 4 | 0000 | |
resultMsg | AN | 255 | Result Message: Error Code | SUCCESS |
bankVacctNo | N | 30 | Virtual Account Number | 111111101003086046 When Success |
tXid | AN | 30 | Transaction ID | IONPAYTEST00202212231003086046 When Success |
referenceNo | ANS | 40 | Order Number | ordNo20221223101289 When Success |
amount | N | 12 | Transaction Amount | 10000 When Success |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20221223 When Success |
transTm | N | 6 | Transaction Time (HH24MISS) | 100308 When Success |
bankCd | A | 4 | Bank Code | CENA When Success |
description | AN | 100 | Transaction Description | Testing+Transaction+Virtual+Account When Success |
Catatan: Response parameter akan dikirimkan melalui callBackurl dengan Content-type: application/json dan metode: POST Parameter.
Pada pembayaran saat Checkout, response dari request yang di-hit adalah Callback URL.
Saat Callback diterima callbackUrl Anda, kami merekomendasikan Merchant untuk melakukan verifikasi Status dengan menggunakan Status Inquiry - API Checkout.
CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud. Kami sangat merekomendasikan Merchant untuk melakukan verifikasi menggunakan CallBack parameter .
