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 under Organization-level permissions.
- To create payment links, select the account under Account-level permissions 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 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.
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.