Connect Airwallex Account for Dispute Management

Connect Airwallex to Synctrack

Airwallex Dispute Management is marked BETA in-app — it's live this release while we finish validating, so some steps may change.

Synctrack connects to your Airwallex account with a scoped API key that you create yourself. A scoped key only grants the three permissions Synctrack needs — reading your payments, managing your disputes, and uploading evidence files — so Synctrack can never move your money.

Available on Basic+ plan.

Step 1: Create a scoped API key on Airwallex

In your Airwallex account, go to Developer → API keys, open the Scoped keys tab, and click New scoped key.

Give the key a name you'll recognise later, for example Synctrack and under Account permissions → Accounts, select the Airwallex account you want to connect. This is required; the form won't continue while it's empty.

Leave Global permissions (Accounting, Billing, Spend, Webhooks) switched off — Synctrack doesn't need any of them.
Still under Account permissions, expand Payment Acceptance and tick exactly these:

Payment Acceptance → Read
Payment Disputes → Read and Write

Expand Supporting Services and tick Upload Files → Write.

Click Next, then Create (you can skip the Set IP whitelist) and Airwallex will show the key once. Copy both the Client ID and the API key before you close the page — the API key cannot be viewed again.

Step 2: Connect the key in Synctrack

In Synctrack, go to Settings → Account settings → Payment gateway and open the Airwallex tab.
Click Connect Airwallex account.

Paste the Client ID and the API key. Both must come from the same key. Then Save.

The account now appears with its connection date and Connected via API key. If Airwallex rejects the values, check that you copied both from the same key and that the key hasn't been revoked. If the key is missing a permission, Synctrack names the exact rows you still need to tick.

Step 3 (optional): Get updates in real time

A webhook is not an alternative to the API key. It only changes how fast dispute updates reach Synctrack. Everything Synctrack sends back to Airwallex — submitting evidence, challenging, accepting — always goes through the API key from Step 2. Skipping this step costs you nothing but speed.

Without a webhook, Synctrack pulls updates from Airwallex every 10 minutes. With one, Airwallex pushes each change the moment it happens.

In Airwallex, go to Developer → Webhooks and click New webhook.

Give it a name, for example Synctrack, and set the Notification URL to your Synctrack webhook endpoint [https://apps.synctrack.io/apis/dispute/airwallex-webhook].

Under events, select all of the Account events.
Save. On the Webhook created screen, copy the secret that starts with whsec_. Airwallex shows it here so you can verify that incoming events really came from Airwallex.

Back in Synctrack, open the Airwallex connection, paste the value into Webhook secret (optional), and save.

The Airwallex tab then shows Realtime updates on instead of Checking periodically — add a webhook secret for near-instant updates.

Good to know

Airwallex shows an API key only once. To rotate it, use Enter a new API key — the Client ID is filled in for you and you paste a freshly created key. Make sure the new key belongs to the same Airwallex account, or it connects as an extra account instead of replacing the old one.
You can connect more than one Airwallex account with Connect another account.
If Airwallex revokes access, the account shows Reconnect needed and syncing stops. Everything already synced stays where it is.
Disconnecting stops tracking numbers syncing to Airwallex and stops new disputes arriving for that account. Orders and disputes already synced are left untouched. Note that disconnecting clears the webhook secret on the Synctrack side but does not remove the webhook you registered in Airwallex — if you reconnect later, add the secret again to get real-time updates back.

Updated on: 14/09/2026

Was this article helpful?

Thank you!