Airwallex

Airwallex is a global payment service provider (PSP) with native support for cross-border and FX payments. Stigg’s native integration with Airwallex allows you to collect payments for self-service subscriptions, sales-led contracts and credit top-ups using Airwallex.

​

How it works

1. When customers subscribe to a plan, contract or attempt to top-up credits Stigg generates an invoice.
2. Stigg pushes the invoice to Airwallex.
3. Payments is collected using Airwallex.
4. Airwallex reports the payment status back to Stigg.
5. Once payment is successful, the status of the subscription and top-up is updated accordingly and access is granted.
6. Recurring renewals follow steps 1–4 without any customer interaction. When usage-based pricing is defined, generated invoices will reflect the reported usage.

​

Entity mapping

​

Setting up the integration

Setting up the integration takes two steps: get your credentials from Airwallex, then enter them in Stigg.

​

1. Get your credentials from Airwallex

In the Airwallex dashboard for the environment you’re connecting (sandbox or production):

1. Go to Developer > API keys and click New scoped key.
2. Give the key a name, grant it the permissions listed below, and create it.
3. Copy the key’s Client ID (shown in the API keys table) and the generated API key.
4. Obtain your Org ID (org_...). You can find it on the API key’s Overview page, under Access to > Organisation.
5. Go to Settings, and under Entities, open the account you want Stigg to route checkouts to. Copy the Account ID (acct_...) from the Account details panel.

You’ll also need the API URL for the Airwallex environment you’re connecting:

​

Permissions required

Grant the scoped API key the following permissions, at the level shown for each:

​

2. Enter the credentials in Stigg

1. In the Stigg app, go to Integrations and click Add integration.
2. Find Airwallex in the list of available integrations and select it.
3. Fill in the credentials from step 1:
   • Client ID
   • API Key
   • API URL
   • Org ID
   • Account ID
4. Click Connect.

That’s it. The integration shows as Active in your list of active integrations.

​

Implementing checkout

You can collect payment through Airwallex in one of two ways:

• Stigg Checkout widget: the quickest option, with no payment-specific code on your side.
• Custom checkout experience: for a fully custom checkout experience in your own UI.

Either way, Stigg generates the invoices and Airwallex collects the payment for them.

​

Using the Stigg Checkout widget

Render Stigg’s checkout widget as you normally would. When Airwallex is your environment’s invoicing integration, the widget automatically renders Airwallex’s embedded payment form, saves the customer’s payment method in Airwallex, and provisions the subscription in Stigg. No Airwallex-specific configuration is needed.

​

Custom checkout experience

To build your own checkout:

1. Collect the payment method with Airwallex’s embedded payment form
2. Attach the payment method to the customer with the consent ID as the paymentMethodId and AIRWALLEX as the vendorIdentifier. The consent becomes the customer’s default payment method for future charges.
3. Provision the subscription or credit grant in Stigg.

​

Accessing Airwallex entities from Stigg

In the Stigg app, clicking on the link of the “billing ID” property will open the relevant entity in Airwallex:

• Customers link to the customer in Airwallex.
• Subscriptions and credit grants link to their invoice in Airwallex.

​

Beta limitions

The following flows are not currently supported:

1. Creating subscriptions and contracts with payment links.
2. Applying discounts using coupons.

​

Removing the integration

To remove the integration, click on the dotted menu icon and select the Remove action. Confirm the action by clicking on the Remove button in the opened modal.

​

Related articles