Common use cases and example apps
Choose a prompt based on how your customers pay or what your team needs to track.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.
- To create payment links, select the account that accepts payments and grant Write for Payment Links.
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.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:
- Environment: keep Sandbox (testing) for test payments or select Production for real payments.
- Client ID: enter the client ID for the selected environment.
- API key: enter the key paired with that client ID.
- 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 checks that Airwallex accepts the client ID and API key. Passing this check does not confirm that the key can access the intended account or perform the actions your app needs.If your app gets a permission error, check the key’s permissions in Airwallex and grant any missing permission. If the key covers several accounts, enter the intended account’s ID under Advanced settings in the Lovable connection.
Receive payment updates after checkout
If your app confirms orders or bookings after payment, set up payment notifications. Airwallex can notify your app when a payment succeeds even if the customer never returns from checkout. Creating the connection does not register your app for notifications.1
Get the notification URL
Ask Lovable to add a webhook endpoint to receive and verify Airwallex notifications. Ask for its URL and the events it handles.
2
Register the URL in Airwallex
In the Airwallex environment that matches your connection (sandbox or production), go to Developer → Webhooks and click New webhook. Name the webhook and enter the URL Lovable gave you under Notification URL.Select the events your endpoint handles, such as
payment_intent.succeeded for a successful payment. 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.
Switch from sandbox to production
To accept real payments, create a separate Airwallex connection. Under Environment, select Production and enter your production client ID and API key. Unlink your project from the sandbox connection, then ask Lovable in the project chat to link the production connection. If your app sends customers to Airwallex hosted checkout, publish the app after linking the production connection. Until you publish, the checkout page on your live site still opens Airwallex in sandbox mode. If your app uses payment notifications, ask Lovable for the production webhook URL:- For a webhook on your app’s website, publish the webhook changes and use the published webhook URL, not the preview URL.
- For a Supabase Edge Function, use the deployed function’s URL.
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.