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
OverviewBefore you startNative UI Integration
RedirectWeChat PayApple Pay
SDK Examples
Android Airwallex SDK
Registered user checkout
Airwallex iOS SDK Privacy Details
Native API
Automatic Currency Conversion
Invoice integrations


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.