Log inGet started
Airwallex logo
Core API
Transactional FX
Back to home
OverviewChoose your payments solutionGet started with payments
Online payments
Online payments overviewGet started with online paymentsHosted Payment Page
Drop-in Element
Embedded Elements
Mobile SDK
Guest user checkout
iOS Airwallex SDK
Android Airwallex SDK
OverviewBefore you startNative UI Integration
SDK Examples
Registered user checkout
Airwallex iOS SDK Privacy Details
Native API
Automatic Currency Conversion
Invoice integrations

Native UI Integration

We provide native screens to facilitate the integration of payment functions. You can integrate edit shipping info flow to manage shipping info of the order and use our prebuilt payment flow to present payment flow to your shopper.

  1. Initialize an Airwallex object, it’s the entry-point of the Airwallex SDK

  2. Set up a ClientSecretProvider

Set up an ClientSecretProvider in your app, make your API client class implement the ClientSecretProvider interface, which defines a single method, provideClientSecret. When implementing this method, pass the customerId parameter along to your generate_client_secret endpoint. Consult our Example App to see this in practice.


Edit shipping info flow

Use presentShippingFlow method to allow users to provide a shipping address as well as select a shipping method. The shipping parameter is optional. After successfully saving, it will return a shipping object.


Payment flow

One-off payments

  1. (Optional) Create a Customer API if you want to save your customer's details and attach payment information to them (This step is compulsory when you process recurring payment for a new customer)
  2. Create a Payment Intent API on your server and pass it to your client
  3. Create a payment session with corresponding payment type and order information
  4. Present payment flow by passing payment session to Airwallex SDK
  5. Query and present payment result in callback functions

Integration steps for Redirect module and Card module are the same, they only differ in actions performed by the SDK.

However, when incorporating WeChat Pay module, you need to implement another callback function onResp declared by WeChat SDK to check the payment result which will be invoked when the shopper completes payment in WeChat app and gets redirected back to your app.

Recurring payments

Recurring payments involves three types of payment flow:

  1. When capturing a credential for the first time
  2. Subsequent client initiated transactions (CIT)
  3. Subsequent merchant initiated transactions (MIT)

For integrations steps of all scenarios, please see integration guide at Recurring page

Custom Theme

You can overwrite these color values in your app.


See Android developer guide for: Styles and Themes | Android Developers