Search...
APIJSLog inGet started in sandbox
Airwallex logo
Home
Platform APIs
Connected Accounts
Accounts
Payments
Billing
Transactional FX
Payouts
Issuing
Embedded Finance Use Cases
Global Treasury
Banking as a Service
Payments for Platforms
Developer Tools
Trust Center
Help Center
API Reference
Back to home
OverviewHow Airwallex Billing worksGet started with billingChoose your billing solutionConfigure your billing settingsSupported currencies
Invoicing
Subscriptions
Billing components
Customers
Products
Prices
Payment sourcesCheckout
Hosted Billing CheckoutOther checkout options
Test and go live

Other checkout options

Embedded Elements, Payments Native API, and Mobile SDK integration options require additional API calls to build and manage subscriptions.

Integrate with Embedded Elements

Embed Airwallex UI components into your checkout page to collect payment details from shoppers. Learn more in Card Element Registered User Checkout, Split Card Element Registered User Checkout and Drop-in Element Registered User Checkout.

Billing - Drop-in Element

Airwallex's native Payments API integration allows you to handle 100% of the interactions between your application's frontend and backend. Native API is best suited when you would like to provide a highly customized checkout experience to your shoppers. Learn more in Native Payments API Registered User Checkout.

Airwallex’s mobile SDK integrations enable you to incorporate the Airwallex payments module into your mobile app for processing payments. It’s available on both iOS and Android platforms. It provides native UI pages to facilitate the payment flow from selecting payment methods to submitting required information and redirecting shoppers to other payment apps or webpages. Learn more in iOS SDK Registered User Checkout and Android SDK Registered User Checkout.

Build your subscriptions integration

On completion of a checkout flow using any integration options above, the customer’s payment details are captured in a verified Payment Consent API object.

Follow these steps to create a subscription with the customer’s payment details you collected through the checkout flow.

Step 1: Create a Billing customer

Refer to Create Billing customer to create and manage a billing customer.

Step 2: Create a payment source

To start a subscription, you must first create a Payment source API object as a funding instrument that can be used to pay for invoices. You will need to pass the following fields in Create a payment source API request:

  • external_id: The ID of a verified Payment Consent.
  • linked_payment_account_id: ID of your Airwallex account that you want to use to collect payment. You can find this ID in the Airwallex web app > Settings > Account details, within the Account Information section.

Step 3: Create a subscription

Call Create a subscription API with the following fields:

  • billing_customer_id: Provide the ID of the billing customer created with Create a Billing Customer API from step 1.
  • collection_method: Set to AUTO_CHARGE.
  • linked_payment_account_id: ID of your Airwallex account that you want to use to collect payment. You can find this ID in the Airwallex web app > Account > Account details, within the Account Information section.
  • payment_source_id: Provide the ID of the billing customer created with Create a payment source API from step 2.

Refer to Subscriptions for detailed information on how to create and manage subscriptions.

Was this page helpful?
On this page
Was this page helpful?