Create individual cards (older API versions)

• Contact your Airwallex Account Manager to enable Cards, Issuing APIs, and other required configuration for your Airwallex account (Integration checklist).
• Obtain your access token API by authenticating to Airwallex using your unique Client ID and API key. You will 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 Airwallex account is active.
• (Optional) Set up webhooks to receive notifications on card events.

Individual cards require a cardholder against whom the card will be issued. Use Create a Cardholder API to create a cardholder object with the required parameters such as name, email, address, etc.

You must also provide the individual.express_consent_obtained parameter, and set it to yes to confirm cardholder's consent for identity verification. This consent allows Airwallex to verify the cardholder's identity with Airwallex service providers and database owners in accordance with the Identity Verification Terms

The response returns the cardholder object with all the request parameters, and the following cardholder details:

• cardholder_id: A unique identifier of the cardholder object. You can use this to:
  • Update cardholder details, see Update a cardholder API.
  • Retrieve cardholder details and status anytime, see Get cardholder details API.
• status: The status of the cardholder (see Cardholder statuses).

After successfully creating a cardholder, create an individual card and assign it to the cardholder. Submit Create a card API request by providing the following parameters:

• issue_to: Set this to INDIVIDUAL to indicate that you want the card issued to an individual.
• cardholder_id: Use the cardholder_id returned in Create a Cardholder API response.
• form_factor: Set this to VIRTUAL or PHYSICAL (if applicable for your region). For information on requirements for physical cards, see Physical cards.
• type: The type of card. If you do not provide a value, the default configuration on your account setting is used. Possible values: PREPAID, DEBIT, GOOD_FUNDS_CREDIT.
• created_by: Your full legal name.
• request_id: Specify a unique request ID.
• authorization_controls.allowed_transaction_count: Specify whether the card is a single (SINGLE) or multi-use (MULTIPLE) card. Single-use cards can only be used for one successful debit transaction.
• authorization_controls.allowed_transaction_limits: Set limits on transactions such as transaction amount, intervals, etc. See Transaction limits.

The response returns the card object with all the request parameters, and the following card details:

• card_id: A unique identifier of the card object. You can use this to:
  • Retrieve the full PAN and CVV of your individual cardholders using Get sensitive card details API, only if you are PCI compliant (see Step 2).
  • Check if you have sufficient funds on the card for your future spend using Get card remaining limits API.
  • Retrieve details of the card object including card status anytime using Get card details API. If you want to retrieve details of all cards issued to your account, see Get all cards API.
  • Update the card object for transaction limits, allowed currencies, allowed merchant categories, etc., using Update a card API.
• card_number: A masked card number.
• card_status: The status of the card (see Card statuses). A virtual card will be automatically set to ACTIVE so you can use the card to transact immediately. For physical cards, see Activate a card.

As an Airwallex customer, you can retrieve sensitive card details of cardholders anytime after card creation as long as you are PCI compliant . To retrieve full PAN and CVV, call Get sensitive card details API by providing the card_id in the endpoint URL.

Alternatively, you can serve up card details via secure iframes (does not require PCI compliance).

• Check cardholder status
• Create a commercial card
• Create a consumer card