Skip to main content
Airwallex lets businesses accept and manage payments in multiple currencies. If you already take payments with Airwallex, you can use the same account for checkout, invoicing, and reporting in your Lovable app. If you haven’t chosen a payment provider, start with Lovable payments. Airwallex is available as an app + chat connector: one shared connection that works in Chats, in the project chat while you build, and in your published apps. To see balances or payment totals, ask Lovable to build a page in your app rather than requesting the figures in the project chat.

Common use cases and example apps

Choose a prompt based on how your customers pay or what your team needs to track.
The connection gives your app access to Airwallex. It does not control who can see the financial data your app displays. For an internal dashboard, ask Lovable to require sign-in and check that the viewer belongs to your finance team before returning invoices or balances.

How to connect Airwallex

Who can create Airwallex connections depends on your plan and workspace settings. App + chat connectors are available by default. On Business and Enterprise plans, Who can create connections and clients starts at Admins. Some Enterprise workspaces start at No one, which disables the connector. An admin or owner changes it in Connectors → Admin settings → App + chat connectors. You can create separate connections for sandbox and production. Sandbox payments move no real money. When the connection is created, you can link it to the projects where you want to use it. Anyone building in a project can ask Lovable in the project chat to link their project to it. Linking follows the connection’s access rules.

Prerequisites

Before connecting Airwallex, make sure you have:
  • An Airwallex account and access to its developer settings. Ask an Airwallex owner, admin, or developer to create the key if you don’t have access.
  • Airwallex Billing enabled on the account if you want your app to manage subscriptions or invoices.
  • Permission to create connections in your Lovable workspace.
Airwallex, not Lovable, bills your Airwallex account for processing production payments.

Step 1: Get your Airwallex credentials

Airwallex issues separate credentials for sandbox and production. Start with a sandbox key to test your app.
1

Open API keys in Airwallex

For test payments, sign in to the Airwallex sandbox and open API keys in your developer settings. For real payments, open production API keys instead.
2

Create a scoped key

A scoped key limits your app to the resources and actions you select. An admin key grants all API permissions for the account or organization it belongs to. Click New scoped API key and enter a name.Choose permissions for the tasks your app performs. For example:
  • To list invoices, grant Read for Invoices under Organization-level permissions.
  • To create payment links, select the account under Account-level permissions and grant Write for Payment Links.
If your app does both, configure both permission levels on the same key.
3

Save the client ID and API key

Click Create. Store the API key securely and keep the client ID paired with it. Airwallex shows the key only once.If the key covers several accounts, open Settings → Account details for the account your app should use. Copy the account ID that starts with acct_, not the organization ID.
For other tasks, use Airwallex’s API key scopes to find the resource and permission your app needs.

Step 2: Connect Airwallex to Lovable

Enter your credentials in the connection form, not in the project chat.
1

Open Airwallex in Connectors

Open Connectors and select Airwallex. For the other places to open the catalog from, see Where to find connectors.
2

Add a connection

Click Connect on the connector page. The form is split into collapsible sections, Details, Configure connection, and Sharing.
3

Name the connection

Under Details, Lovable fills in a name, which you can change. Choose a name such as Airwallex sandbox so you can tell it apart from your production connection.
4

Configure the connection

Under Configure connection, enter:
  1. Environment: keep Sandbox (testing) for test payments or select Production for real payments.
  2. Client ID: enter the client ID for the selected environment.
  3. API key: enter the key paired with that client ID.
  4. Account ID: if your key is linked to several accounts, expand Advanced settings and enter the account ID you copied. Otherwise, leave it blank.
5

Choose who can use this connection

Under Sharing, the connection is private to you by default and shows a Private label. To share it, click Share with others. Then add workspace members by email, or click Invite entire workspace to make the connection available to everyone in your Lovable workspace.See Who can use connections and clients for more information.
6

Connect

Click Connect at the bottom of the form. Lovable verifies the client ID and API key against Airwallex before saving the connection. A key doesn’t need permission to read balances to pass this check.
When connected, anyone building in a project can ask Lovable in the project chat to link their project to Airwallex. Linking follows the connection’s access rules. To try checkout without charging a customer, link your sandbox connection and use an Airwallex test card.

Receive payment updates after checkout

Airwallex can notify your app when a payment succeeds, even if the shopper closes checkout. Connecting Airwallex does not register your app for these notifications.
1

Get the notification URL

Ask Lovable to add a webhook endpoint that receives and verifies Airwallex notifications, and to give you its URL.
2

Register the URL in Airwallex

In the matching Airwallex environment, go to Developer → Webhooks and click New webhook. Name the webhook and enter your app’s URL under Notification URL. Select the payment events your app needs and click Submit.
3

Save the signing secret

Copy the signing secret for that URL from Airwallex. Ask Lovable for a secure secret form and enter the secret there so your app can verify the notifications.

Limitations

The Airwallex connector cannot:
  • Retrieve full card numbers for issued cards.
  • Let each person using your app sign in to their own Airwallex account. The connection uses the account you configured.

Manage your Airwallex connection

Connections are managed from Connectors: select Airwallex, then open the connection.
  • Unlink projects to remove Airwallex access from specific projects while keeping the connection available for others. See Unlink projects from a connection for the steps.
  • Delete the connection to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use Airwallex stop working until a new connection is added. See Delete a connection for the steps and who can delete.