VA Integration & Testing

11 min

The integration and testing process for the Virtual Account payment method covers 6 features of the Virtual Account. Those features are Normal Close, Normal Open, Fixed Close, Fixed Open, NICEPAY Inquiry Virtual Account Close, and NICEPAY Inquiry Virtual Account Open.

Integration Steps and API Used

Perform API Call Transaction Registration integration.

SNAP: Registration - API Virtual Account SNAP.

Redirect: Virtual Account - API Checkout.

Receive NICEPAY callback and push notification.

Perform API Inquiry Status integration.

SNAP: Check Status Transaction - API Virtual Account SNAP

Redirect: Status Inquiry - API Checkout.

Optional: perform API Cancel integration to cancel the transaction.

SNAP: Cancel - API Virtual Account SNAP.

Redirect: Cancel - API Checkout .

Virtual Account Testing Guide

Test Steps	Rules and Conditions
Use MID Merchant or MID sandbox (IONPAYTEST) AutoPaid. Create Regist Virtual Account. Access to MBanking application or Internet Banking. Check your inquiry payment. Confirmation of your payment. Transaction success. Check your (dbProcessUrl) notification.	Transaction will be settled based on the Bank rules. When payment success, funds on the Customer account will immediately deduct based on the paid amount on Virtual Account. Virtual Account transaction that has been through the Settlement process could not be aborted.

Failed Transaction Possible Reason

VA number / billing number not found.

Company code not found.

Input the wrong VA number.

Payment time already expired so the VA number can’t be used anymore.

Payment with VA number successfully but got timeout from Bank.

Integration Checklist & Test Case

Implement inquiry status after receiving the callback.

Implement inquiry status after receiving the notification inside dbProcessUrl.

Review payment log.

Review firewall setting (eg. cloudflare for dbprocessUrl setting).

Check merchantToken implementation.

Execute test scenarios in Development Environment.

Execute test scenarios in Production Environment. Get Sample Scenario

Review Error Handling (Timeout, Failed, Negative Case).

Best Practice

For Merchant testing, able to install merFixAcctld parameter. Learn further related to API Virtual Account SNAP, Virtual Account Static.

Virtual Account Cancel support to full cancellation and partial cancellation. Learn further about Cancel Type Code.

When notification is received on your dbProcessUrl, NICEPAY strongly recommend Merchant to verify the notification using the Inquiry API.

Notification Handling is helpful to minimalize Fraud actions, NICEPAY strongly recommends Merchant to verify the Notification Handling.