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

PayNow QR

Accept payments easily via PayNow without the hassle of manual reconciliation. PayNow is the most widely used alternative form of payment method in Singapore which relies on the Unique Entity Number (UEN) of a company instead of relying on lengthy bank account numbers.

The key difference between Xfers' PayNow solution is that instead of using the same QR code for all your customers, your customers can simply scan a unique QR code that is generated by Xfers for faster checkout without filling in ANY additional details, whether the amount or a reference code.

Xfers offers 2 solutions for our PayNow mode of payment;

1. Persistent QR Code — suitable for each customer & account

Features:

  • A unique QR code can be assigned to each of your customers
  • Customers can enter the payment amount manually
  • Ability to set a time-validity period before QR code expires

Use-cases:

  • For investment platforms, where no fixed amount is needed for deposits
  • For making top-ups to an e-wallet

2. Dynamic QR Code — suitable for invoices & checkouts

Features:

  • QR code changes with each transaction
  • Customers do not need to enter any amount manually and can make the payment directly
  • All the fields will be locked to prevent any user error
  • Ability to set a time-validity period before QR code expiry or for one-time use

Use-cases:

  • For marketplaces or social sellers with many one-time customers
  • For merchants who offer fixed pricing for your products

Your customer also doesn't need to manually send you a screenshot or inform you of the payment because we will do that for you.

Benefits of using Xfers PayNow

  1. Unique QR code for each invoice, instead of sticking to the single PayNow Corporate QR code that was retrieved from your bank
  2. Save time and effort of having to manually reconcile PayNow payments
    3, Enhanced user experience
  3. You will be notified of the payment response almost instantaneously when your customer has made the payment.

Maximum Amount (SGD)

20,000

Payment Availability

Available throughout the day.

We do not expect any delays unless a customer changes the reference code embedded in the QR code by brute force. In that case, we will need to reach out to you to resolve the payment.

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): PayNow 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 payment has succeeded or not.

Refunds

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

Cancelling a QR code

It is currently not possible to cancel a QR code that has already been generated. You are able to set the expiry of the QR code before generation. The default expiry time of all generated QR codes is fixed as 5 minutes.

Creating a Payment Method (Persistent Payment) with PayNow QR Mode of Payment

# POST api/v4/payment_methods/paynow
{
    "data": {
        "attributes": {
            "referenceId": "MY_CUSTOMER_000001",
            "merchantPrefix": "PHOHANOI",
        },
        "relationships": {
            "customerProfile": {
                "data": {
                    "id": "customer_profile_bf72e369-fc3d-4cde-9e4e-5713db9577f3"
                }
            }
        }
    }
}

Find out more in our API Docs; Payment Methods

Creating a Payment (Dynamic Payment) with PayNow QR Mode of Payment

// POST api/v4/payments
BASE_URL="http://xfers.io/api

POST {{BASE_URL}}/v4/payments
Basic Auth
{
    "data": {
        "attributes": {
            "amount": "0.1",
            "referenceId": "pennytest_123",
            "paymentMethodType": "paynow",
            "expiredAt": "2021-04-03T20:03:53+07:00",
            "paymentMethodOptions": {
                "merchantPrefix": "PHOHANOI"
            }
        },
        "relationships": {
            "customerProfile": {
                "data": {
                    "id": "customer_profile_bf72e369-fc3d-4cde-9e4e-5713db9577f3"
                }
            }
        }
    }
}

Find out more in our API Docs; Payments

Updated 9 days ago


PayNow QR


Suggested Edits are limited on API Reference Pages

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