Regular Payment

Overview

You can generate a unique virtual bank account or PayNow QR for payment collections. When our system successfully receive payments from the payers, we will trigger a webhook callback to your system for you to complete the transactions.

Sequence Diagram

Create a Virtual Bank Account (VA) or PayNow QR

To accept payments, you have the option to either create a virtual bank account or generate a persistent/dynamic PayNow QR code.

Virtual Bank Account (VA): You can create a virtual bank account to obtain bank transfer details, which you can then provide to the payer. This allows the payer to add a payee in their banking app and complete the transfer.

• SGD VA: This account is created instantly.
• USD VA: Activation typically takes 1 day. StraitsX will send a callback to the URL specified on your StraitsX Business Dashboard once the account status is updated. Note that additional information might be requested, and in some cases, the USD account application may be declined.

PayNow QR: Alternatively, you can also create PayNow QR which you can display to the payers for them to easily scan and make transfer.

• Persistent PayNow: You can create a persistent PayNow payment method and provide a QR code to your payers. This allows any payers to make multiple payments using the same QR code.
• Dynamic PayNow: You can create a dynamic PayNow payment to generate a unique QR code for each individual transaction. When creating a dynamic PayNow QR code, you need to specify the amount and expiry date. Once a payment is made to a dynamic PayNow QR code, it cannot be used for additional payments. This is suitable and useful for checkout scenario.
• Note: Ensure that payers do not alter the reference number that is automatically populated after scanning the PayNow QR code, as modifications may result in payment rejection.

Accepting Payment

Once the payers make a payment to the VA or PayNow QR provided, StraitsX will send a callback notification to you via the callback URL indicated on the StraitsX Business Dashboard. Learn more about callback configuration.

In the event that a payment is blocked by StraitsX, a callback will be fired to you with the blocked code. In some cases, supplementary information or proof may be required to continue processing the payment.

Note: If a payment is less than the transaction fees charged, no amount will be credited to your account.

ℹ️

Sandbox Testing

To test your integration, you could initiate a mock bank transfer or mock PayNow payment. Callback will also be sent in the sandbox environment.

Webhooks

Webhook callbacks use HTTP POST request with the event in string format and expects 200 OK in the response. Each failed webhook callback is retried up to 20 times with a 5-minute interval. If you need to retrigger callback for a single contract or a list of contracts, you can do so via our callback event endpoints.

For incoming payments, a sample webhook callback looks like the following:

amount=0.01&bank_account_no=3225300696000&blocked_reasons%5B%5D%5Bcode%5D=NM-001&created_at=2024-06-03T07%3A28%3A09.908Z&currency=xsgd&end_to_end_ref=Transfer&fees=0.01&id=contract_d176576dfb1a498ead53d2b5f77e4122&idempotency_id=SUBSCRIPTION_0cd2163dc32dfdb76250db29f58da2ec&merchant_ref=ref_0d1w4m0xepp40&sender_bank=DBS+Bank+Ltd&sender_bank_account_holder_name=JOHN+DOE&sender_bank_account_no=01234567&sender_bank_swift_bic=DBSSSGSGXXX&status=pending&transaction_remarks=abc&type=Direct+bank+transfer