---
title: How to Connect Airwallex to OneSuite
description: "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…"
url: "https://help.onesuite.io/docs/how-to-connect-airwallex-to-onesuite/"
updated: "2026-11-16"
category: Payment Integration
---

# How to Connect Airwallex to OneSuite

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?

1. Click your name at the bottom of the sidebar, then click **Settings**.
2. Under **Integrations**, click **Payment**.
3. On the **Payment Methods** page, find **Airwallex** and click **Connect**.
4. In the Airwallex web app, open **Settings**, then **Developer**, then **API keys**.
5. Copy your Client ID.
6. Paste it into **Client ID** in OneSuite.
7. Generate an API key.
8. If you scope the key, give it **Write** access to **Payment Acceptance**.
9. Paste the key into **API key**.
10. Check the **Currency**.
11. Click **Save**.

![](https://help.onesuite.io/wp-content/uploads/2026/11/image-1024x931.png)

## 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:

1. Open the invoice.
2. Switch Airwallex on in its **Payments** panel.
3. 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](https://www.airwallex.com/docs/developer-tools/api/api-key-scopes), 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](https://help.onesuite.io/docs-category/payment-integration/).

**Record the money that arrives:** Log payments made outside a gateway with [How to Record Invoice Payments](https://help.onesuite.io/docs/how-to-record-invoice-payments/).
