Payment
Virtual Account (VA)

VA Integration & Testing

13min

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, 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 .