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
.



Updated 13 Mar 2024
Did this page help you?
PREVIOUS
VA Feature
NEXT
VA Transaction Settlement
Docs powered by Archbee