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

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.

​

Troubleshooting

​

The integration shows a setup error

If Stigg can’t complete the setup, a warning icon appears next to the integration name. Hover over it to see the reason. The most common cause is missing permissions: the API key is missing one of the required permissions, or a permission is granted at the wrong level. Create a new scoped key with the correct permissions and reconnect.

​

Links to Airwallex open a permission error

If clicking a billing ID link in Stigg opens a “You do not have the permission to view this page” screen in Airwallex, your Airwallex user’s role can’t view billing data. This is the case for the Developer and Employee roles. Ask an admin of your Airwallex organization to assign you a role with billing access. See Accessing Airwallex entities from Stigg for the list of roles.

​

Beta limitations

The following are not currently supported:

1. Creating subscriptions and contracts with payment links.
2. Applying discounts using coupons.
3. 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