Payment
Virtual Account (VA)

VA Integration & Testing

13 min

The  and   for    covers 6 features of  . 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


  1. Perform  Call Transaction Registration .
  2. Receive  callback and push .
  3. Perform  Inquiry Status .
  4. Optional: perform  Cancel  to cancel  .



Virtual Account Testing Guide



Test Steps

Rules and Conditions

  1. Use MID  or MID sandbox (IONPAYTEST) AutoPaid.
  2. Create Regist .
  3. Access to MBanking application or Internet Banking.
  4. Check your inquiry .
  5. Confirmation of your .
  6. Transaction success.
  7. Check your (dbProcessUrl) .
  1. Transaction will be settled based on   rules.
  2. When  success, funds on   account will immediately deduct based on  paid amount on .
  3.   that has been through    could not be aborted.



Failed Transaction Possible Reason


  1. VA number / billing number not found.
  2. Company code not found.
  3.   wrong VA number.
  4.  time already expired so  VA number can’t be used anymore.
  5.  with VA number successfully but got timeout from .



Integration Checklist & Test Case



Implement inquiry  after receiving  callback.

Implement inquiry  after receiving   inside dbProcessUrl.

Review  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  , able to install merFixAcctld . Learn further related to API Virtual Account SNAP, API Virtual Account, Virtual Account Static.
  •  Cancel support to full cancellation and partial cancellation. Learn further about Cancel Type Code.
  • When  is received on your dbProcessUrl,  strongly recommend  to verify   using  Inquiry .
  • Notification Handling is helpful to minimalize Fraud actions,  strongly recommends  to verify  Notification Handling.



See also

  VA Payment Flow  to find out    during  with  .

  VA Feature  to find out   feature on  .

 the VA Glossary  to find out  particular term used on .

  VA FAQ  if you want to find out frequently asked questions related to .



Updated 23 Jun 2025
Did this page help you?
PREVIOUS
VA Feature
NEXT
VA Transaction Settlement
Docs powered by Archbee