Integration · Airwallex

Pay contractors from your Airwallex balance

Connect Airwallex with a scoped API key. Pay runs leave your balance per currency and land in your contractors' bank accounts. Local transfers are free on Airwallex; you pay their FX, we show it.

Free for 7 days, then flat plans from $29/mo.

What syncs

What Handl does with Airwallex

Airwallex is the payout rail for agencies whose Wise account can't fund transfers from Handl, or who simply hold their money in Airwallex.

  • Pay runs from your balances.

    Statements are drafted from approved hours, approved by you, then paid from your per-currency Airwallex balances.

    When

    When you approve a run. A person approves every run, and nothing moves before that.

  • Bank payouts to contractors.

    Each contractor is paid to their bank account. The contractor receives the full statement total and you wear the fee.

    When

    Bank payouts only. Handl doesn't pay to a contractor's Airwallex account.

  • Status and remittance.

    Handl tracks each payout's status through an Airwallex webhook and emails the contractor a remittance. Paid history shows in their portal.

    When

    As Airwallex reports each payout's status.

Division of labour

What stays where

Handl does

  • Drafts each statement from approved hours
  • Approval, caps and the audit log
  • Tracks status and emails the remittance
  • Books approved expenses and adjustments into project costs

Airwallex does

  • Holds your per-currency balances
  • Moves the money to the contractor's bank account
  • Converts currency and charges its own fee, which you pay

Handl never holds the money.

Setup

How to connect Handl to Airwallex

You create a scoped API key in Airwallex and paste it, with its client id, into Handl.

Have these ready

  • An Airwallex account in a region that supports payouts (AU, HK, SG, UK, EU, US and more; check Airwallex for your country).
  • Permission to create an API key in Airwallex.
  • A balance in the currency you want to pay from.
  1. Step 1: Open API keys in Airwallex.

    Airwallex → Developer → API keys.

  2. Step 2: Create a key and tick Balances and Payouts.

    Scope it to balances and payouts only.

  3. Step 3: Copy the client id shown with the key.

    You paste the client id and the API key into the Connect Airwallex dialog in Handl.

  4. Step 4: Connect, set caps and invite a contractor.

    Payouts go to contractors' bank accounts. Set max per run and per contractor, then the first statement drafts itself.

The step-by-step is also in the Help Centre, linked in the questions below.

Airwallex

Connect Airwallex

Client ID

e.g. 7f2a…

API key

Paste your Airwallex API key

Scope it to balances and payouts only.

Where to find it

  1. Airwallex → Developer → API keys
  2. Create a key, tick Balances and Payouts
  3. Copy the client id shown with the key
  4. Payouts go to contractors' bank accounts
CancelConnect

Airwallex balances

AUD
21,300.00
USD
4,950.00
EUR
2,110.00

Local transfers free · FX shown per payout

Example data. Labels from the live Connect Airwallex dialog.

The honest bit

What to know first.

  • Bank payouts only.

    Handl pays contractors' bank accounts from Airwallex. There's no pay to their Airwallex account. Regions include AU, HK, SG, UK, EU and US and more: check Airwallex for your country.

  • Local transfers free. FX 0.5% for majors, 1% for others.

    Local transfers free to 120+ countries, FX 0.5% above interbank for major currencies and 1% for others, SWIFT $10 to 30 (airwallex.com/au/pricing, 26 Oct 2026). Airwallex's own plan starts at $0 or $29 a month. You pay Airwallex. We show it.

Time in, books out

Hours in. Pay out. Books updated.

Airwallex sits in the middle of the same flow as the rest of Handl: the hours come in, the client invoice goes out, the contractor gets paid, and the books stay in your accounting tool.

  • Hours in

    Harvest, Toggl, Clockify, Hubstaff and Upwork timesheets supply the approved hours that each statement is drafted from.

  • Handl

    Drafts the statement, runs the approval and books the cost to the project.

  • Airwallex

    Pays the contractor's bank account from your balance, fee shown on every payout.

  • QuickBooks or Xero

    Client invoices and payments sync as they do today. Approved expenses and adjustments land in Handl project costs.

See all integrations

Frequently asked questions

Does Handl hold my money?
No, never. Pay runs leave your own Airwallex balance and go to the contractor's bank account.
What can the API key do?
Whatever scopes you tick when you create it. Scope it to balances and payouts only. You can delete the key in Airwallex at any time.
Can I pay a contractor's Airwallex account?
No. Airwallex payouts from Handl go to bank accounts.
Which countries does it work in?
Airwallex supports AU, HK, SG, UK, EU, US and more. Check Airwallex for your country and for the countries your contractors are in.
What if I disconnect?
Disconnect Airwallex in Handl, and delete the key in Airwallex to cut off access completely. Pay runs can't be funded from Airwallex until you connect it again or connect Wise.
Which plans include it?
Pay your team is $5 per contractor paid, per month, on every plan. Free while we're in early access, until 31 January 2027. You pay the provider's transfer fee directly and Handl adds nothing to it.
Is there a step-by-step guide?

Pay your team

Hold your money in Airwallex? Start your first pay run.

7-day free trial on every plan. Pay runs are $5 per contractor paid, per month. Free while we're in early access, until 31 January 2027.

Start your 7-day free trial