Integrasi & Testing VA

11 min

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

Lakukan integrasi API Call Transaction Registration.

SNAP: Registration - API Virtual Account SNAP.

Redirect: Virtual Account - API Checkout.

Menerima callback dan push notification dari NICEPAY.

Lakukan integrasi API Status Inquiry.

SNAP: Check Status Transaction - API Virtual Account SNAP.

Redirect: Status Inquiry - API Checkout.

Opsional: lakukan integrasi API Cancel untuk membatalkan transaksi.

SNAP: Cancel - API Virtual Account SNAP.

Redirect: Cancel - API Checkout.

Cara Uji Coba Virtual Account

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

Alasan Peluang Transaksi Gagal

Nomor VA / nomor tagihan tidak ditemukan.

Kode perusahaan tidak terdaftar.

Memasukkan nomor VA yang salah.

Waktu pembayaran sudah habis sehingga nomor VA sudah tidak bisa digunakan.

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

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, Virtual Account Static.

Virtual Account Cancel mendukung untuk membatalkan secara penuh dan sebagian. Pelajari lebih lanjut mengenai Cancel Type Code.

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.