---
title: Virtual Account - API Checkout
slug: nicepay-api-virtual-account-payment-api-checkout
description: Informasi tentang API Checkout - Payment untuk metode pembayaran Virtual Account yang disediakan oleh NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/RThrVHkeBqbyvH-9rwsN9_rdrx9d8diazpgm07xfz2test-1.png
icon: {"faIcon":"fa-solid fa-credit-card"}
docTags:
createdAt: 2022-12-19T10:12:12.000Z
---
# Tentang Virtual Account - API Checkout
***
API ini digunakan oleh Merchant untuk melakukan pengajuan pembayaran kepada NICEPAY dengan metode pembayaran Virtual Account menggunakan Checkout API.
# Alur Proses
***
Deskripsi langkah:
1. Pelanggan melakukan *checkout*.
2. Pelanggan mengirimkan data *checkout *kepada Merchant.
3. Merchant melakukan pengajuan *checkout *menggunakan API Registration kepada NICEPAY.
4. NICEPAY mengalihkan Merchant kepada halaman pembayaran.
5. Merchant mengirimkan halaman pembayaran NICEPAY kepada Pelanggan.
6. Pelanggan memilih metode pembayaran.
7. Pelanggan membayar menggunakan VA kepada Bank.
8. Bank melakukan proses pembayaran.
9. Bank mengirimkan hasil pembayaran kepada Pelanggan.
10. Bank mengirim notifikasi pembayaran kepada NICEPAY.
11. NICEPAY memperbarui status pembayaran.
12. NICEPAY mengirim notifikasi `dbProcessUrl` kepada Merchant.
13. Merchant menerima status.
14. Merchant mengajukan status inquiry kepada NICEPAY.
15. NICEPAY menerima pengajuan.
16. NICEPAY mengirimkan *response* status inquiry kepada Merchant.
17. Merchant menerima status terakhir.
18. Merchant mengirim halaman hasil transaksi kepada Pelanggan.
# NICEPAY Secure Payment Page
***
:::hint{type="info"}
Silakan kunjungi halaman [Panduan Bayar VA](docId\:bSNUZMHNlj9h0wRndsQYj) 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
***
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` |
## Request Parameters for Virtual Account - API Checkout (CallbackUrl)
***
| **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 |
## Response Parameters for Virtual Account - API Checkout (CallbackUrl)
***
| **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** |
| ------------- | -------- | ---------- | ----------------------------------------------------------- | ----------------------------------------------------------- |
| `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 |
| `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | 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](docId:1U7QOax_wrzXMoCG-Mqad) | CENA
When Success |
| `description` | AN | 100 | Transaction Description | Testing+Transaction+Virtual+Account
When Success |
:::hint{type="info"}
Catatan: *Response* parameter akan dikirimkan melalui `callBackurl` dengan Content-type: `application/json` dan metode: `POST Parameter`.
:::
## Sample Parameter for Virtual Account - API Checkout (CallbackUrl)
***
:::hint{type="success"}
Pada pembayaran saat *Checkout*, *response *dari *request *yang di-*hit *adalah Callback URL.
:::
### Request Parameter
:::CodeblockTabs
cURL
```curl
curl -X GET "https://www.merchant.com/callbackUrl?resultCd=0000&resultMsg=SUCCESS&bankVacctNo=111111101003086046&tXid=IONPAYTEST00202212231003086046&referenceNo=ordNo20221223101289&transDt=20221223&transTm=100308&amount=10000&bankCd=CENA&description=Testing+Transaction+Virtual+Account"
```
:::
### Callback Parameter
:::CodeblockTabs
Response Callback
```curl
resultCd=0000
resultMsg=SUCCESS
bankVacctNo=111111101003086046
tXid=IONPAYTEST00202212231003086046
referenceNo=ordNo20221223101289
transDt=20221223
transTm=100308
amount=10000
bankCd=CENA
description=Testing+Transaction+Virtual+Account
```
:::
## Callback Handling API Checkout Transaction Payment
***
:::hint{type="success"}
Saat *Callback *diterima `callbackUrl` Anda, kami merekomendasikan Merchant untuk melakukan verifikasi Status dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3).
:::
:::hint{type="warning"}
`Callback Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. Kami sangat merekomendasikan Merchant untuk melakukan verifikasi menggunakan `Callback parameter` .
:::
::Image[]{src="https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/v9H6Et-FTr7kKQ5pEtNHu_nicepay-api-checkout-api-callback-handling-flow-1.png" size="50" width="370" height="361" position="center" caption="Callback Handling API" alt="Callback Handling API" showCaption="true"}
:::CodeblockTabs
URL Callback
```json
"callbackUrl" : "https://www.merchant.com/callbackUrl/"
```
Response Callback
```json
resultCd:0000
resultMsg:SUCCESS
bankVacctNo:111111101452274313
tXid:IONPAYTEST00202212201452274313
referenceNo:ordNo20221220141258
transDt:20221220
transTm:144009
amount:10000
bankCd:CENA
description:Testing API
```
:::