Xfers Payments

The Xfers Payments Developer Hub

Welcome to the Xfers Payments developer hub. You'll find comprehensive guides and documentation to help you start working with Xfers Payments as quickly as possible, as well as support if you get stuck. Let's jump right in!

Guides    API Reference

Virtual Account

Virtual Accounts allows businesses to accept payments easily via bank transfer without the usual hassle of manual reconciliation of such payments. Since the majority of payments in the Southeast Asian regions are made through bank transfers, this is an extremely important payment method for your platforms.

Benefits of using Xfers VA

  1. Save time and effort of having to manually reconcile bank transfer payments
  2. No need to open bank accounts across various banks.
  3. You will be notified of the payment response almost instantaneously when your customer has made the payment.

Payment Limits

Maximum Amount (SGD))


Payment Availability

Virtual Accounts are usually available throughout the day.

Payment responses are typically fast. However, if the customer has made a payment using a bank account from a different bank to the Virtual Account, there may be a delay of up to a few working hours.

Payment Notifications

When using virtual accounts as a payment method, please note that this will require further customer action to complete the payment. Customers will be required to make the funds transfer through their bank’s online service, or an ATM.

  • Delayed (Asynchronous): Bank transfer payments have delayed notification and cannot guarantee payment during the delay. The status of the Payment object will be pending until the payment is either successful or failed. It’s common for businesses to hold an order in a “pending” state during this time, not fulfilling the order until the payment is successful.

For payment methods that require customer action, we recommend setting up callbacks so that you can be notified whether a payment has succeeded or not.


Please note that refunds are not available for bank transfer payment methods at this moment.

Closing a VA

It is currently not possible to close a VA.

Creating a Payment with Virtual Account Payment Method

# POST api/v4/payment_methods/virtual_bank_accounts
  --header 'content-type: application/vnd.api+json' \
  -u test_api_key:secret_key \
  -d '
    "data": {
      "attributes": {
        "referenceId": "customer_id_123456",
        "bankShortCode": "CIMB"

Updated about a month ago

Virtual Account

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.