PayNow 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.

Before you begin

This page explains how to add PayNow to your existing iOS Drop-in integration. The iOS Drop-in integration works the same way for all payment methods. If you haven't done this integration yet, refer to our Drop-in integration guide.

Before starting your PayNow integration:

1. Make sure that you have set up your back end implementation, and added Drop-in to your payment form.
2. Contact our Support Team to enable PayNow.

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:

1. 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.

1. Pass data.paymentMethod to your server.

2. 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.

See also