TrueMoney Drop-in integration

Our iOS Drop-in renders TrueMoney in your payment form, and redirects the shopper to the TrueMoney's website where they can complete the payment.

When making an TrueMoney payment, you additionally need to:

• Handle the redirect result after the shopper returns to your website.

Requirements

Show TrueMoney 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.

To show TrueMoney in your payment form, specify in your /paymentMethods request:

• countryCode: TH
• amount.currency: THB
• 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.
   • returnUrl: The URL where the shopper will be redirected back to after completing the payment. This URL can have a maximum of 1024 characters. Use the custom URL for your app, for example, my-app://. For more information on setting custom URL schemes, refer to the Apple Developer documentation.

   In the /payments response, check the action object for the information that you must use to redirect the shopper.

3. Pass the action object to your client app.

Handle the redirect

Drop-in uses dropInComponent.handle(action) to redirect the shopper to TrueMoney.  

1. To inform Drop-in when the shopper returns to your app, implement the following in your UIApplicationDelegate:

func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey: Any] = [:]) -> Bool {
    RedirectComponent.applicationDidOpen(from: url)
    return true
}

After Drop-in completes the action, it invokes the didProvide method.

2. From your server, make a POST /payments/details request providing the data from the didProvide method from your client app.

You receive a response containing:

• resultCode: Use this to present the result to your shopper.

• pspReference: Our unique identifier for the transaction.

Present the payment result

Use the resultCode that you received in the /payments/details response to present the payment result to your shopper.

The resultCode values you can receive for TrueMoney are:

If the shopper closed the browser and failed to return to your website, wait for webhooks to know the outcome of the payment. The webhooks you can receive for TrueMoney are:

Recurring payments

1. Create a shopper token.
2. Use the token to make future payments for the shopper.

Create a token

To create a token, include in your /payments request:

• storePaymentMethod: true
• shopperReference: Your unique identifier for the shopper.

This triggers the recurring flow, where the shopper logs in to their TrueMoney account, and then confirms the recurring transaction.

When the payment has been settled, you receive a recurring.token.created webhook containing:

• type: recurring.token.created
• shopperReference: your unique identifier for the shopper.
• eventId: the pspReference of the initial payment.
• storedPaymentMethodId: the token that you need to make recurring payments for this shopper.

Make a payment with a token

To make a payment with the token, include in your /payments request:

• paymentMethod.storedPaymentMethodId: The storedPaymentMethodId from the recurring.token.created webhook or from additionalData.tokenization.storedPaymentMethodId if you are retrieving the token synchronously.

  You can also get this value using the /listRecurringDetails endpoint.

• shopperReference: The unique shopper identifier that you specified when creating the token.

• shopperInteraction: ContAuth

• recurringProcessingModel: Use Subscription for a series of transactions following a fixed time interval or UnscheduledCardOnFile for contracts with non-fixed time interval.

Test and go live

To test successful TrueMoney live payments, you need to use a real mobile number registered with a TrueMoney account.

If you are encountering issues with testing TrueMoney payments, contact our Support Team.

Check the status of TrueMoney test payments in your Customer Area > Payments > Payment list.

Before you can accept live TrueMoney payments, you need to submit a request for TrueMoney in your live Customer Area.

See also