Create individual cards
Individual cards are cards issued to named individuals who are authorized representatives of your business. The individual’s name is listed against the card, and the cards may be issued as virtual or physical cards as well as added to a digital wallet if supported in the applicable region. Individual cards may be issued to employees, contractors, or any representative of the business.
Learn how to create individual cards and retrieve card details.
Before you begin
- 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.
Step 1: Create a cardholder
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
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).
Some regions may require additional KYC identification information such as passport, driver's license, etc., to verify cardholder's identity. If required, upload document images using File Service API.
Step 2: Create an individual card
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
INDIVIDUALto indicate that you want the card issued to an individual.
cardholder_id: Use the
cardholder_idreturned in Create a Cardholder API response.
form_factor: Set this to
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:
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
ACTIVEso you can use the card to transact immediately. For physical cards, see Activate a card.
status must be
READY for individual cards to be issued.
Step 3: Retrieve sensitive card details
As an Airwallex customer, you can retrieve sensitive card details of your individual 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 PAN delegation (does not require PCI compliance).