Airwallex

Create a virtual or physical card associated with a cardholder. Requires a cardholder - use create_cardholder to create a cardholder first. Requires authorization controls including a spending limit. All amounts are in major currency units (e.g. 10.00 for ten dollars), not in minor units such as cents.

create_card

Create a new cardholder for issuing. Cardholders are authorized representatives of your business who can be assigned cards. INDIVIDUAL: Associated with a named person. Can hold personalized or non-personalized cards. Requires: individual object with name, date_of_birth, address, and express_consent_obtained. DELEGATE: Acts as an authorized user. Can only hold non-personalized cards (e.g. virtual card for company spending). Only requires: email. Defaults to DELEGATE when cardholder_type is omitted. All cardholder PII (email, name, date_of_birth, addresses, mobile_number) must come from the user. Do not fabricate or use placeholder values. Omit fields the user has not provided. EXAMPLES: • DELEGATE team spender: cardholder_type="DELEGATE", email=<user-provided> • INDIVIDUAL employee: cardholder_type="INDIVIDUAL", email=<user-provided>, individual={<user-provided name, date_of_birth, address>, express_consent_obtained: "yes"} • Physical card delivery: cardholder_type="INDIVIDUAL", email=<user-provided>, individual={<user-provided>}, postal_address=<user-provided> • Then issue card: use returned cardholder_id with create_card

create_cardholder

Create a payment link and optionally send it via email to a shopper. Supports two pricing modes: - Fixed pricing: provide `amount` + `currency`. The shopper pays the exact amount. - Flexible pricing: provide `default_currency` + `supported_currencies`. The shopper picks the currency and amount. All amounts are in major currency units (e.g. 10.00 for ten dollars), not in minor units such as cents. EXAMPLES: • Fixed invoice: title="Invoice #1042", amount=150.00, currency="USD", reference="INV-1042" • Flexible checkout: title="Project donation", default_currency="USD", supported_currencies=["USD", "EUR", "GBP"] • Email payment request: title="March membership", amount=29.99, currency="USD", shopper_email=<only if user supplied email> • Reusable pay link: title="Pay Acme Corp", reusable=true, default_currency="USD", supported_currencies=["USD", "EUR"]

create_payment_link

Delete one or more line items from a draft invoice. Only possible when the invoice status is DRAFT. Up to 100 line items can be deleted per call; the bulk operation is atomic — either all deletions succeed or none are applied.

delete_billing_invoice_line_items

Finalize a draft invoice. Once finalized, the invoice status changes from DRAFT to FINALIZED and it is issued for payment. This action cannot be undone — use void_billing_invoice to cancel a finalized invoice.

finalize_billing_invoice

Get a current foreign exchange rate for a currency pair. Provide either buy_amount or sell_amount, but not both. If neither is provided, buy_amount defaults to 100. All amounts are in major currency units (e.g. 10.00 for ten dollars), not in minor units such as cents.

get_fx_rate

Retrieve BUSINESS information for the authenticated Airwallex account. Use this tool only to look up business account details: it returns the account's identifiers, status, and metadata, the business details (business name, address, identifiers, operating countries, URLs, state of incorporation), and the associated business persons (name, nationality, roles). It does not return individual-account details.

get_account_details

Retrieve balances for all currencies. All amounts are in major currency units (e.g. 10.00 for ten dollars), not in minor units such as cents.

get_account_balances

Get the required and optional fields for creating a beneficiary. Returns the field schema for a given country, currency, entity_type, and transfer method combination. Always call this before create_beneficiary to discover what bank details and other fields are required.

get_beneficiary_schema

Retrieve all amendments associated with a conversion ID. Currently only full cancellations are supported, so a conversion will only have up to 1 associated amendment.

list_fx_conversion_amendments

List FX conversions (scheduled, settled, overdue, or cancelled currency conversions). If neither from_created_at nor to_created_at is specified, results for the last 31 days are returned.

list_fx_conversions

Get balance history for an account. Each record is a change to the balance. Filter with from_post_at (inclusive) and to_post_at (exclusive). Date-range cap: each call must span at most 7 days (to_post_at − from_post_at ≤ 7 days). Exceeding this returns a 400 error. For multi-week requests, split into consecutive <=7-day windows and make one call per window — e.g. 3 months requires ~13 separate calls of 7 days each. Prefer a clean end like T00:00:00Z over T23:59:59Z. Paginate within a window via page_num or the page_after / page_before cursor.

list_balance_history

List beneficiaries with optional filters. Default page size is 100.

list_beneficiaries

List billing coupons.

list_billing_coupons

List billing customers.

list_billing_customers

List line items for an invoice.

list_billing_invoice_line_items

List invoices.

list_billing_invoices

List billing meters. A Meter defines how to aggregate Usage Events over a billing period to determine how much a customer should be billed.

list_billing_meters

List billing payment sources. A Payment Source represents a Billing Customer's saved funding instrument that can be used to pay invoices or drive subscriptions. Payment Sources are an opaque abstraction over the underlying payment provider Payment Method — responses contain only tokenised IDs (id, billing_customer_id, external_id, linked_payment_account_id) plus metadata and timestamps. No card data (PAN, last4, expiry, brand, cardholder name) is exposed by this endpoint.

list_billing_payment_sources

List billing prices.

list_billing_prices

List billing products.

list_billing_products

List subscription items for a given subscription created with create_billing_subscription.

list_billing_subscription_items

List billing transactions for a given invoice. Returns payment and refund transactions associated with the specified invoice.

list_billing_transactions

List all cardholders with optional filters.

list_cardholders

List issued cards with optional filters. Defaults to a 30-day period unless both from_created_at and to_created_at are populated.

list_cards

List inbound transactions (funds received via bank transfer) for a specific Global Account. Date-range cap: each call must span at most 31 days (to_created_at − from_created_at ≤ 31 days). Exceeding this returns 400 time_range_exceed. Note: 31 days is not the same as one calendar month — calendar months have 28–31 days and a T23:59:59Z end will push a 31-day month over the cap. For multi-month requests, split into consecutive <=31-day windows and make one call per window — e.g. a 6-month period requires ~6 separate calls of 31 days each. A Global Account is a multi-currency receiving account that provides local bank details (e.g. IBAN, BSB, routing number) for receiving inbound bank transfers and authorizing direct debit payouts — not the customer's Airwallex account. Use list_global_accounts to find the global_account_id.

list_global_account_transactions

List the customer's Global Accounts. A Global Account is a multi-currency receiving account that provides local bank details (e.g. IBAN, BSB, routing number) for receiving inbound bank transfers and authorizing direct debit payouts — not the customer's Airwallex account. To check wallet balances across currencies, use get_account_balances instead.

list_global_accounts

List card transactions associated with an account or for a specific card. IMPORTANT: If the customer uses the Airwallex Spend product and wants to see their card expenses, prefer list_spend_card_expenses over this tool. If you are unsure whether the customer uses the Spend product, ask them before choosing between this tool and list_spend_card_expenses. Each card transaction includes its status, fund direction, merchant details, and aggregated billing amounts. Use lifecycle_id to retrieve all card transactions within a specific lifecycle, or status to filter by transaction status.

list_issuing_transactions

List PaymentIntents. If no results are returned, it means no payments have been initiated yet. Should advise the user to create a PaymentIntent first via their application before using this tool. Unless the user has explicitly asked for create payment intent via API, do not suggest for native integration.

list_payment_intents

List payment links created by the merchant. Supports filtering by active flag, status, reusable, and a created_at time range.

list_payment_links

List refunds. Supports filtering by PaymentIntent/PaymentAttempt, status, currency, and a created_at time range.

list_refunds

List spend bills (accounts payable obligations). If from_created_at is not specified, defaults to last 30 days from to_created_at. If to_created_at is not specified, defaults to now.

list_spend_bills

List expenses related to issued corporate card transactions. IMPORTANT: If the customer uses the Airwallex Spend product, prefer this tool over list_issuing_transactions when they want to see their card expenses. If you are unsure whether the customer uses the Spend product, ask them before choosing between this tool and list_issuing_transactions.

list_spend_card_expenses

List spend vendors (accounts payable / purchase order vendor records). If from_created_at is not specified, defaults to last 30 days from to_created_at. If to_created_at is not specified, defaults to now.

list_spend_vendors

List transfers with optional filters. If neither from_created_at nor to_created_at is given, the last 30 days are returned. Max range is 30 days: (to_created_at - from_created_at) must be at most 30 days, else the API returns 400 time_range_exceed. A full calendar month can exceed it (31-day months, or a T23:59:59Z end). Split longer periods into consecutive <=30-day windows (one call each); don't retry an over-long window.

list_transfers

Mark a finalized invoice as paid out-of-band. Use this for invoices that the customer has already paid through a channel outside Airwallex (e.g. bank transfer, cash, check). After this call, the invoice's payment_status moves to PAID and paid_out_of_band is set to true. The invoice itself remains FINALIZED.

mark_billing_invoice_as_paid

Retrieve a billing customer by ID.

retrieve_billing_customer

Retrieve an invoice by ID.

retrieve_billing_invoice

Retrieve a billing transaction by ID.

retrieve_billing_transaction

Retrieve the full details of a single issued card by ID. Returns all card attributes including status, authorization controls, cardholder association, brand, masked card number, and delivery details.

retrieve_card