Connect Airwallex so your clients can pay invoices online through it. Go to Settings > Integrations > Payment and click Connect on the Airwallex card. Paste your Client ID and API key from the Airwallex web app, choose a Currency, and click Save. If you use a scoped API key (a key limited to certain permissions), it needs Write access to Payment Acceptance.
In this guide you’ll learn how to:
- Find your Airwallex Client ID and API key
- Give a scoped API key the access it needs
- Connect Airwallex to OneSuite
- Switch Airwallex on for an invoice
Before you start
- You need an Airwallex account and access to the Airwallex web app.
- You need access to Settings. If you can’t see Integrations, ask an admin.
- Your API key is a private code from Airwallex. It lets OneSuite work with your Airwallex account. Keep it private.
- Airwallex shows the API key once, when you generate it. Have a place ready to save it.
- Each Client ID and API key belongs to one environment. Take both from the same one. An environment is a separate setup of your account, such as a test setup or a live setup.
What does OneSuite ask for when you connect Airwallex?
| Field | Where to find it | Required |
|---|---|---|
| Client ID | In the Airwallex web app, open Settings, then Developer, then API keys. It stays the same when you generate the API key again. | Yes |
| API key | On the same page. Airwallex shows it once. A scoped key needs Write access to Payment Acceptance. | Yes |
| Currency | Starts as US Dollar (USD). OneSuite uses it when an invoice has no currency of its own. | No |
How do I connect Airwallex to OneSuite?
- Click your name at the bottom of the sidebar, then click Settings.
- Under Integrations, click Payment.
- On the Payment Methods page, find Airwallex and click Connect.
- In the Airwallex web app, open Settings, then Developer, then API keys.
- Copy your Client ID.
- Paste it into Client ID in OneSuite.
- Generate an API key.
- If you scope the key, give it Write access to Payment Acceptance.
- Paste the key into API key.
- Check the Currency.
- Click Save.

How do I check it worked?
The Airwallex card on the Payment Methods page now says Connected instead of Not connected. You also see Airwallex marked Connected under Invoices > Configure > Getting paid > Online payments.
OneSuite switches a connected gateway on for every new invoice. An invoice you created earlier keeps its own choice. To use Airwallex on an older invoice:
- Open the invoice.
- Switch Airwallex on in its Payments panel.
- Save the invoice and send it again.
FAQs
Which Airwallex API key permission does OneSuite need?
A scoped key needs Write access to Payment Acceptance. Airwallex lists Payment Acceptance on its API key scopes page, with Read and Write columns.
Does the Airwallex Client ID change when I regenerate the API key?
No. Only the API key changes. Your Client ID stays the same.
Can I see my Airwallex API key again?
Airwallex shows the API key once, when you generate it. Save it as soon as you create it.
What to do next
See every gateway: Browse all the guides in Payment Integration.
Record the money that arrives: Log payments made outside a gateway with How to Record Invoice Payments.