Virtual Account - API Checkout
API ini digunakan oleh Merchant untuk melakukan pengajuan pembayaran kepada NICEPAY dengan metode pembayaran Virtual Account menggunakan Checkout API.
![Alur Pembayaran VA dengan Checkout API Alur Pembayaran VA dengan Checkout API](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/n88kWq7chrzSS1lWQ2LfE_nicepay-archbee-payment-va-new-va-redirect.png?format=webp)
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.
![Secure Payment Page Secure Payment Page](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/ht4_JU7NuZ_HpXokoi-Sl_id-new-secure-payment-page-gpn.png?format=webp)
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.
![Virtual Account - Secure Payment Page Virtual Account - Secure Payment Page](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/Pzm1xZ2DZU1sq_-zduAQj_id-new-secure-payment-page-bank-transfer-2.png?format=webp)
Setelah memilih metode dengan transfer Bank, Pelanggan Anda akan disediakan daftar Bank yang dapat dipilih untuk melanjutkan proses pembayaran.
![Success - Secure Payment Page Success - Secure Payment Page](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/axJr6DQbqJuwLfadp0Zaa_id-new-secure-payment-page-bank-transfer-3.png?format=webp)
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 .
![Callback Handling API Callback Handling API](https://images.archbee.com/ZHvSjR5ZrsoxwKbJa3xmo/v9H6Et-FTr7kKQ5pEtNHu_nicepay-api-checkout-api-callback-handling-flow-1.png?format=webp)