Create cards

The Issuing Cards API provides the flexibility for creating cards tailored to fit your use case. After determining your issuing solution (see Choose your issuing solution), you can start building your integration for your business requirements.

Before you begin

• Familiarize yourself with the Airwallex card offering.
• Contact your Airwallex Account Manager to enable Cards, Issuing APIs, and other required configuration for your Airwallex account (see Integration checklist).
• Obtain your access tokenAPI by authenticating to Airwallex using your unique Client ID and API key. You need the access token to make API calls.
• Make sure you have sufficient funds in your Airwallex Wallet for future card spend. For more information, see Fund your issuing balance.
• Ensure your onboarding obligations have been met and your account is active.
• (Optional) Set up webhooks to receive notifications on issuing events.

Build your card integration

• Create commercial cards
• Create consumer cards
• Physical and digital cards
• White-label cards

List and retrieve card details

The List all CardsAPI endpoint returns a subset of card fields. Each item includes only additional_cardholder_ids, brand, card_id, card_number, card_status, cardholder_id, created_at, nick_name, and updated_at — it does not include authorization_controls or metadata. To read a card's spend limits, allowed merchant categories, or metadata (for example, card-to-agent attribution), fetch each card individually with Retrieve a CardAPI.

For a view that renders many cards, fetching each card individually creates an N+1 request pattern (one list call plus one request per card), which can make the first load slow. Cache the individual card objects locally with a short time to live (for example, 30 seconds) and invalidate on any card status change, so only the first load in each window pays the per-card fetch cost.