PayNow Drop-in integration

Add PayNow to your existing iOS Drop-in integration.

Our iOS Drop-in renders PayNow in your payment form, and generates a QR code that the shopper uses to pay with their banking app.

Requirements

Select which endpoint you are using:

Show PayNow in your payment form

Drop-in uses the countryCode and the amount.currency from your /paymentMethods request to show the available payment methods to your shopper. Complete the following to show PayNow in your payment form:

Specify the following parameters in your /paymentMethods request:
- countryCode: SG
- amount.currency: SGD
- amount.value: The value of the payment

Make a payment

When the shopper proceeds to pay, Drop-in invokes the didSubmit method which contains data.paymentMethod.

Pass data.paymentMethod to your server.
From your server, make a /payments request, specifying paymentMethod: the data.paymentMethod from the didSubmit event from your client app.

Drop-in generates the QR code that the shopper uses to pay.

Show the payment result

Use the resultCode from the /payments/details response to show the payment outcome on your frontend.

You will also receive the outcome of the payment asynchronously in a webhook.

The resultCode values you can receive for PayNow are:

eventCode	success field	Description	Action to take
AUTHORISATION	false	The transaction failed.	Cancel the order and inform the shopper that the payment failed.
AUTHORISATION	true	The shopper successfully completed the payment.	Inform the shopper that the payment has been successful and proceed with the order.

Test and go live

Before you can accept live payments, you must contact our Support Team to add PayNow in your live Customer Area.

You can penny test PayNow payments in your live Customer Area, using small amounts and a real banking app to scan a test QR.

You can check the status of PayNow payments in your live Customer Area > Transactions > Payments.

We recommend not to test PayNow payments in your test Customer Area. You cannot reverse bank transfers in the test environment, and the funds will be deducted from the bank account.