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:

Test and go live

Test PayNow payments with real payment details and small amounts.

Check the status of your test PayNow payments in your Customer Area > Transactions > Payments.

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

See also