---
title: Integrasi & Testing VA
slug: integrasi-and-testing-va
description: Informasi tentang cara integrasi dan testing pada metode pembayaran Virtual Account dengan sistem NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/_3ghZYJF-6nI8v3ar2AGb_rdrx9d8diazpgm07xfz2test-1.png
icon: {"faIcon":"fa-solid fa-book"}
docTags: 
createdAt: 2022-08-11T08:15:30.000Z
---

Proses integrasi dan testing untuk metode pembayaran Virtual Account mencakup 6 fitur Virtual Account. Fitur tersebut, antara lain *Normal Close*, *Normal Open*, *Fixed Close*, *Fixed Open*, *NICEPAY Inquiry Virtual Account Close*, dan *NICEPAY Inquiry Virtual Account Open*.



# Langkah Integrasi & API yang Digunakan

***

1. Lakukan integrasi API Call Transaction Registration.
   - SNAP: [Registration - API Virtual Account SNAP](docId\:K4DeuHcQ_4pSto2beLqb7).
   - Redirect: [Virtual Account - API Checkout](docId:-D655p6HMEzTcUQJKnxbL).
2. Menerima *callback *dan *push notification *dari NICEPAY.
3. Lakukan integrasi API Status Inquiry.
   - SNAP: [Check Status Transaction - API Virtual Account SNAP](docId\:xaW0SxwKv9j7b5zLbtVpR).
   - Redirect: [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3).
4. Opsional: lakukan integrasi API Cancel untuk membatalkan transaksi.
   - SNAP: [Cancel - API Virtual Account SNAP](docId\:vN3l9wxp-CA7deDK7AtM8).
   - Redirect: [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn).



# Cara Uji Coba Virtual Account

***

| **Langkah Tes**                                                                                                                                                                                                                                                                                       | **Aturan dan Kondisi**                                                                                                                                                                                                                                                                                  |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1. Menggunakan MID Merchant atau MID sandbox (`IONPAYTEST`) AutoPaid.
2. Membuat Regist Virtual Account
3. Masuk ke aplikasi MBanking atau Internet Banking.
4. Memeriksa inquiry payment Anda .
5. Konfirmasi pembayaran Anda.
6. Transaksi berhasil.
7. Memeriksa notifikasi Anda (`dbProcessUrl`). | 1) Transaksi akan di-*settle *berdasarkan peraturan Bank.
2) Ketika pembayaran berhasil, saldo pada akun Pelanggan akan segera berkurang sesuai dengan nominal yang dibayarkan pada Virtual Account.
3) Transaksi Virtual Account yang sudah melalui proses Settlement tidak bisa dibatalkan. |



# Alasan Peluang Transaksi Gagal 

***

1. Nomor VA / nomor tagihan tidak ditemukan.
2. Kode perusahaan tidak terdaftar.
3. Memasukkan nomor VA yang salah.
4. Waktu pembayaran sudah habis sehingga nomor VA sudah tidak bisa digunakan.
5. Pembayaran dengan nomor VA berhasil tetapi terkena *timeout *dari Bank.



# Integration Checklist & Test Case

***

- [ ] Implementasi status inquiry setelah mendapatkan *callback.*
- [ ] Implementasi status inquiry setelah mendapatkan notifikasi di dalam `dbProcessUrl`.
- [ ] Meninjau *log *pembayaran.
- [ ] Meninjau pengaturan firewall (eg. cloudflare untuk pengaturan `dbprocessUrl`).
- [ ] Memeriksa implementasi `merchantToken`.
- [ ] Menjalankan tes skenario pada *Development Environment*.
- [ ] Menjalankan tes skenario pada *Production Environment*. 
  [Get Sample Scenario](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx)****
- [ ] Meninjau *Error Handling* (*Timeout, Failed, Negative Case*).



# Best Practice

***

- Untuk uji coba Merchant, dapat memasang parameter `merFixAcctld`. Pelajari lebih lanjut mengenai [API Virtual Account SNAP](docId:2XCcJFVmwY9jDmD6w09oN), [Virtual Account Static](docId\:TlvtOb_yPO_kFiaaVTqb6).
- Virtual Account Cancel mendukung untuk membatalkan secara penuh dan sebagian. Pelajari lebih lanjut mengenai [Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc).
- Ketika notifikasi diterima pada `dbProcessUrl` Anda, NICEPAY sangat merekomendasikan Merchant untuk melakukan verifikasi notifikasi menggunakan Inquiry API.
- `Notification Handling` berguna untuk meminimalisir aksi *Fraud*, NICEPAY sangat merekomendasikan Merchant untuk melakukan verifikasi `Notification Handling`.



# See also

::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
Kunjungi halaman [Alur Pembayaran VA](docId\:lL0aeF-P7zmvqABj6Oq8G) untuk mengetahui proses pada sistem saat melakukan pembayaran dengan Virtual Account.
:::

:::VerticalSplitItem
Kunjungi halaman [Fitur VA](docId\:GnUAAyq81JNJ8UNRanWUZ) untuk mengetahui fitur transaksi pada Virtual Account.
:::
::::

::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
Kunjungi halaman [Daftar Istilah VA](docId:2xrW5DVjK-076w2JsQvI8) untuk mengetahui istilah khusus yang digunakan oleh Virtual Account.
:::

:::VerticalSplitItem
Kunjungi halaman [FAQ VA](docId\:n5d3A27rcZ6_ZxBN-sIIs) jika ingin mengetahui pertanyaan yang sering diajukan terkait Virtual Account.
:::
::::