Guide - Integrations

How do you analyze Airwallex finance data in Metabase?

Airwallex analytics turns finance operations into shared, queryable models. Airwallex combines global accounts, wallets, payments, payouts, FX, cards, and spend controls. Metabase can unify those flows into treasury, settlement, and cross-border cost dashboards once the API data lands in a database. Metabase connects to the database that holds the synced data; it does not connect natively to Airwallex.

TL;DR - Use the MCP + CLI route for a scoped, short-lived analysis. Use the official API or approved connector route for recurring dashboards, history, permissions, and reconciliation.

How do you connect Airwallex to Metabase?

1 - MCP + CLI route (AI-assisted)

Explore a scoped snapshot quickly

Airwallex hosts an official OAuth-enabled AgentOS MCP for production balances, cash-flow reports, beneficiaries, cards, and other finance workflows. Money-out actions are disabled by default; keep analytics access read-only. Pair the approved server with the Metabase CLI to load a focused CSV as a table and model.

Best for
  • Quick questions about Airwallex data
  • Validating fields and dashboard ideas before building a pipeline
  • Loading a minimal, permissioned snapshot into Metabase
Trade-offs
  • A CSV is a point-in-time snapshot, not governed reporting
  • Finance data needs least-privilege credentials and an explicit tool allowlist
  • Move recurring dashboards to the warehouse-backed route
2 - Pipeline route (warehouse-backed)

Durable dashboards with history

Use the Airwallex API and webhooks to sync global accounts, balances, transactions, payments, payouts, conversions, and fees. Keep connected-account and currency identifiers on every record.

Best for
  • Recurring finance and leadership dashboards
  • Historical aging, lifecycle, and period reporting
  • Joining finance data with sales, product, and operations data
Trade-offs
  • Requires a destination database and maintained sync
  • You own currency, status, accounting period, and reconciliation definitions
  • Every modeled total should reconcile to the source system

What can you analyze from Airwallex?

  • Wallet and global-account balances by currency
  • Collections, payouts, and settlement timing
  • FX conversions, spreads, and fees
  • Cross-border payment corridor performance
  • Card and spend-control activity

Which Airwallex dashboards should you build in Metabase?

For: Finance leaders

Finance overview

A compact view of cash, exposure, and operating performance.

  • Balance by account and currency
  • Collections and payouts
  • Transfers in flight
  • FX and payment fees
For: Finance operations

Operations

The work that needs attention before the next close.

  • Pending payouts
  • Failed collections
  • Settlement lag
  • Card spend awaiting review
For: Controllers

Controls and reconciliation

Find exceptions before they become close surprises.

  • Account-to-ledger exceptions
  • Duplicate payout candidates
  • Unexpected FX variance
  • Webhook or sync freshness
For: FP&A

Planning and trends

Compare actuals with the plan and explain the variance.

  • Liquidity by currency
  • Cross-border fee trend
  • Settlement forecast
  • Payment corridor mix

How do you use Airwallex MCP with the Metabase CLI?

The Airwallex AgentOS MCP is a officialMCP option for AI-assisted exploration. Airwallex hosts an official OAuth-enabled AgentOS MCP for production balances, cash-flow reports, beneficiaries, cards, and other finance workflows. Money-out actions are disabled by default; keep analytics access read-only. The Metabase CLI can then upload a sanitized CSV and create a ready-to-query table and model.

  • Start with a narrow read-only question and the minimum required objects.
  • Remove secrets, bank details, and personal fields before exporting.
  • Use mb upload csv for a first snapshot and mb upload replace for a controlled refresh.
  • Move to an API or connector sync when the dashboard becomes recurring.

How do you set up Airwallex MCP and the Metabase CLI?

Airwallex AgentOS MCPofficial

Data source
Airwallex API
Auth
OAuth against the production Airwallex account
Access
Read-only, least privilege
Use for
Exploration and scoped exports

Metabase CLIofficial

Install
npm install -g @metabase/cli
Auth
mb auth login
Load data
mb upload csv --file data.csv
Requires
An uploads database in Metabase
MCP clientExample MCP configuration - verify before use
{
  "mcpServers": {
    "airwallex": {
      "type": "http",
      "url": "https://mcp.airwallex.com/mcp"
    }
  }
}
TerminalLoad a Airwallex CSV with the Metabase CLI
# Install the Metabase CLI
npm install -g @metabase/cli

# Log in (opens your browser; requires Metabase v62+)
mb auth login --url https://your-metabase.example.com

# Load a scoped Airwallex export - creates a table and a model
mb upload csv --file airwallex-export.csv --collection "Finance & Accounting"

# Refresh the same table later
mb upload replace <table-id> --file airwallex-export.csv
Verify before connecting: check the current Airwallex AgentOS MCP documentation, review every MCP tool, and enable an uploads database under Admin > Settings > Uploads. Use the vendor's documented authentication flow and a least-privilege role for analytics.

Can you generate a Airwallex finance dashboard with AI?

Yes. Use the prompt below with an assistant that can access an approved data route and the Metabase CLI. It tells the assistant to inspect the real schema, reconcile totals, and skip cards that the available data cannot support.

Prompt for a Airwallex finance dashboard
Create a polished Metabase dashboard for Airwallex finance analytics.
Work end to end: find existing modeled data first; if none exists, load a minimal
read-only snapshot or describe the warehouse sync required.

Goal: Connect Airwallex to Metabase for global-account balances, collections, payouts, FX, card spend, and settlement dashboards.

Inspect before querying:
- Inspect actual tables, column names, currencies, status values, and timestamps.
- Do not assume the source schema matches this guide exactly.
- Reconcile source totals before publishing any finance KPI.

Important:
- Do not claim Metabase connects natively to Airwallex; it reads a
  supported database or CLI-uploaded tables.
- Keep native amount, native currency, and reporting-currency amount separate.
- Distinguish authorization, posting, payment, settlement, and reconciliation
  states where the source exposes them.
- Use stable business keys and apply updates/deletes during incremental syncs.
- Exclude account numbers, personal data, and secrets from broad dashboards.
- Only build cards whose required fields and history are actually present.

Dashboard sections:
1. Finance overview: Balance by account and currency; Collections and payouts; Transfers in flight; FX and payment fees.
2. Operations: Pending payouts; Failed collections; Settlement lag; Card spend awaiting review.
3. Controls and reconciliation: Account-to-ledger exceptions; Duplicate payout candidates; Unexpected FX variance; Webhook or sync freshness.
4. Planning and trends: Liquidity by currency; Cross-border fee trend; Settlement forecast; Payment corridor mix.

Suggested models: modeled_airwallex_balances, modeled_airwallex_cash_movements, modeled_airwallex_settlements, modeled_airwallex_fx_cost.

Output: Build the dashboard if you have permission; otherwise provide the exact
questions, SQL, model definitions, and layout. State refresh time, reporting
currency, accounting basis, and any reconciliation caveats.

How do you sync Airwallex into a database or warehouse?

Use the Airwallex API and webhooks to sync global accounts, balances, transactions, payments, payouts, conversions, and fees. Keep connected-account and currency identifiers on every record.

Airwallex API or data service

Start from Airwallex's official interface and authentication documentation. Extract only the finance objects required by the models below.

dlt Airwallex REST pipeline

Scaffold account and wallet resources, then add the payment, transfer, payout, and balance endpoints your model needs.

Implementation checklist

  1. Create a dedicated read-only integration identity and document its scopes.
  2. Land raw records with source IDs, source timestamps, extraction time, and currency fields intact.
  3. Apply updates and deletes idempotently; keep lifecycle history when aging or process metrics depend on it.
  4. Reconcile modeled totals to Airwallex for a closed period before exposing the models broadly.
  5. Connect Metabase to the destination database and schedule model refreshes.

Source documentation

What data model should you use?

EntityGrainUse
global_accountsone row per accountcountry, currency, and bank details
balancesone row per account-currency snapshotliquidity and exposure
payments_payoutsone row per payment or payoutstatus, amount, and settlement
conversionsone row per FX conversionrate, spread, and fee

Build reusable models such as modeled_airwallex_balances, modeled_airwallex_cash_movements, modeled_airwallex_settlements, modeled_airwallex_fx_cost.

Which finance metrics are useful?

Practical SQL patterns

Cross-border fees by currency corridorPostgreSQL
SELECT
  source_currency || ' -> ' || destination_currency AS corridor,
  COUNT(*) AS transfers,
  SUM(source_amount) AS source_volume,
  SUM(fee_amount_reporting_currency) AS fees,
  ROUND(100.0 * SUM(fee_amount_reporting_currency)
    / NULLIF(SUM(source_amount_reporting_currency), 0), 2) AS fee_rate_pct
FROM modeled_airwallex_cash_movements
WHERE movement_type IN ('PAYOUT', 'CONVERSION')
GROUP BY 1
ORDER BY fees DESC;
Available balance by currencyPostgreSQL

Keep native balances visible and translate them with an explicit reporting rate.

SELECT
  balance_date,
  currency,
  available_amount,
  available_amount * reporting_fx_rate AS reporting_currency_amount
FROM modeled_airwallex_balances
WHERE balance_date = (SELECT MAX(balance_date) FROM modeled_airwallex_balances)
ORDER BY ABS(available_amount * reporting_fx_rate) DESC;

Common mistakes

Mixing platform and connected-account records.→ Retain connected account ID and apply tenant permissions in the model.
Calling authorized payments settled cash.→ Use capture, settlement, payout, and balance events as separate lifecycle steps.
Comparing fees in mixed currencies.→ Normalize fees to a reporting currency while preserving native values.

Dashboards

Integrations

Analytics

FAQ

Can Airwallex support bank reconciliation dashboards?
Yes. Sync global-account transaction details and join them to ledger references or payout identifiers.
Should payment and treasury data share one model?
Keep source models separate, then create a conformed cash-movement model with consistent signs, currencies, and lifecycle states.
Does Metabase connect natively to Airwallex?
No. Metabase reads supported databases and uploaded tables. Sync Airwallex data into a database or load a scoped CSV snapshot first.