Log inGet started
Airwallex logo
Online Payments
Transactional FX
Open Banking
Developer Tools
API Reference
Online Payments
Starting with paymentsTransaction and settlement modelPricing model
Integration options
Integration OverviewPayment LinksPayment Links APIHosted Payment PageEmbedded ElementsDrop-in ElementMobile SDK
iOS Airwallex SDK
OverviewBefore you startNative UI Integration
RedirectWeChat PayApple Pay
SDK Examples
Android Airwallex SDK
Native APIPlugins


Integration flow for Card module

iOS Card one-off

  1. (Optional) Create a customer object and store it on your server 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)

    From your server, Create a Customer API by sending request to Airwallex API and save the Customer returned in response.

  2. Create a PaymentIntent

    Your client app will need a PaymentIntent to form a payment session for Airwallex SDK to present payment flow.

    From your server, Create a Payment Intent API and pass it to client app.

  3. Create an AWXOneOffSession with the PaymentIntent created in the previous step, a returnURL to your app, and shipping address and shopper country code of this order.

  4. Present payment flow with the Session created in the previous step, Airwallex SDK will then process the payment flow and return payment status to a delegate when the shopper completes or cancels payment

  5. Query and present payment result

    After the PaymentIntent is confirmed by SDK, this delegate will be called by the SDK automatically and you can check the status to see whether the payment process has been completed or not.


    Note that a completed flow does NOT imply a successful transaction, you need to query the payment result afterwards through your server to know whether the order is paied or not. Inside AWXPaymentResultDelegate, ask your server to retrieve the PaymentIntent.

    On your server, retrieve the Payment Intent API, get the payment result within it and pass it to client app.