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 are 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

Stigg connects to Airwallex using OAuth. You don’t need to create API keys or copy credentials. You sign in to Airwallex and approve the connection.

​

Before you begin

• Airwallex role: you need to be an Owner, Admin or Finance Admin in your Airwallex organization to approve the connection.
• Payment acceptance: the Airwallex account you connect must have payment acceptance enabled. Whether a sandbox account has it by default depends on the country it’s registered in. US and UK sandbox accounts have it enabled by default, while accounts in some other countries don’t. For testing, the quickest fix is to create a US- or UK-based sandbox account. Otherwise, contact Airwallex to enable it.

​

Connecting Airwallex

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. Select the Airwallex environment to connect: Sandbox or Live. Live is only available in production Stigg environments.
4. Click Connect with Airwallex.
5. Sign in to Airwallex, select your organization, review the requested permissions and click Allow.

That’s it. You’re redirected back to Stigg, and the integration is ready to use. If you don’t have an Airwallex account yet, click Create an account under Connect with Airwallex.

​

Permissions requested

During the connection, Stigg requests the following Airwallex permissions:

​

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.

​

Troubleshooting

​

Beta limitations

The following are not currently supported:

1. Applying discounts using coupons.
2. Connecting multiple Stigg environments to the same Airwallex account.

​

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