Payment-method icon

DuitNow iOS Component

Add DuitNow to your existing iOS Components integration.

Our DuitNow Component renders DuitNow in your payment form and collects your shopper's selected bank.

Before you begin

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

Before starting your DuitNow integration:

  1. Make sure that you have set up your back end implementation for making API requests.
  2. Contact our Support Team to enable DuitNow.

Show DuitNow in your payment form

Include DuitNow in the list of available payment methods.

  1. Specify in your /paymentMethods request:

  2. Decode the /paymentMethods response with the PaymentMethods structure.

    let paymentMethods = try JSONDecoder().decode(PaymentMethods.self, from: paymentMethodsResponse)

    Find paymentMethods.type duitnow and put it into an object. For example, duitnowPaymentMethod.

  3. Create an instance of APIContext with the following parameters:

    Parameter name Required Description
    clientKey -white_check_mark- Your client key.
    environment -white_check_mark- Use test. When you're ready to accept live payments, change the value to one of our live environments
  4. Initialize the DuitNow Component:

    let duitnowComponent = DuitNowComponent(paymentMethod: duitnowPaymentMethod, apiContext: apiContext)
    duitnowComponent.delegate = self
    // In this example, the Pay button will show 10 MYR.
    // The value is in minor units. Change the currencyCode to the currency for the DuitNow Component.
    duitnowComponent.payment = Payment(amount: Amount(value: 1000,
                                                                  currencyCode: "MYR"))
    present(duitnowComponent.viewController, animated: true)

Make a payment

When the shopper proceeds to pay, the Component invokes the didSubmit method containing the data.paymentMethod from the PaymentComponentDelegate.

  1. Pass the data.paymentMethod to your server.
  2. From your server, make a /payments request, specifying:

    • paymentMethod.type: The data.paymentMethod from your client app.

    The response contains the following data:

  • resultCode: Pending
  • action: Contains the QR code url and qrCodeData.

Show the QR code

Use the information in the action object of the /payments response to render the QR code.

  • action.url: Use this URL to download the QR code.
  • action.qrCodeData: Use this to render the QR code on your checkout page.

The shopper can either scan the QR code, or take a screenshot of the QR code and upload it to their bank app.

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

If you are implementing an additional use case, you can make a /payments/details call to receive an immediate response.

Test and go live

Test DuitNow payments with real payment details and small amounts.

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

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

See also