Log inGet started
Airwallex logo
Home
Online Payments
Treasury
Transactional FX
Payouts
Issuing
Scale
Open Banking
Developer Tools
API Reference
Home
Issuing
Overview
Issuing Use Cases
Getting Started
Create CardsManage CardsCreating Cardholders
Manage CardholdersView Transactions
Merchant Category Codes

Creating Cardholders

The cardholder object is the resource associated with a named individual who is a representative/agent of your business and will hold cards associated to them.

To create a cardholder, use the Create a Cardholder API API. A successful request returns a cardholder_id which can be passed into the other Issuing Card APIs to create and manage the cardholder's cards.

Please note:

  1. The ID requirements vary depending on the region in which your business resides. Please read the field decriptions in the Create a Cardholder API API to determine which fields are required for your region.
  2. If required, ID documents will require an image upload. Please refer to the File Service API API to perform this
  3. For each new cardholder resource created, we require the express_cardholder_consentfield to be passed. By setting this field to ‘yes’ you confirm that you have the express consent of this individual for Airwallex to verify their identity with Airwallex service providers and database owners in accordance with the Identity Verification Terms .

Sample Request

curl --request POST \
--url 'https://pci-api-demo.airwallex.com/api/v1/issuing/cardholders/create' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0b20iLCJyb2xlcyI6WyJ1c2VyIl0sImlhdCI6MTQ4ODQxNTI1NywiZXhwIjoxNDg4NDE1MjY3fQ.UHqau03y5kEk5lFbTp7J4a-U6LXsfxIVNEsux85hj-Q' \
--data '{ \
  "address": { \
    "city": "Melbourne", \
    "country": "AU", \
    "line1": "44 Gillespie St", \
    "line2": "Unit 2", \
    "postcode": "3121", \
    "state": "VIC" \
  }, \
  "email": "john@example.com", \
  "individual": { \
    "date_of_birth": "1982-11-02", \
    "express_consent_obtained": "yes", \
    "identification": { \
      "country": "AU", \
      "document_back_file_id": "NzI3ZDAxM2ItZjMzMC00ZDIyLTk4YTQtMTE3ZTA0MjdhZTUyLHwsaG9uZ2tvbmcsfCxwYXNzcG9ydC5qcGdfMTYwNzY0MDI4OQ", \
      "document_front_file_id": "NzI3ZDAxM2ItZjMzMC00ZDIyLTk4YTQtMTE3ZTA0MjdhZTUyLHwsaG9uZ2tvbmcsfCxwYXNzcG9ydC5qcGdfMTYwNzY0MDI4OQ", \
      "expiry_date": "2028-08-28", \
      "gender": "F", \
      "number": "001238243", \
      "state": "NT", \
      "type": "DRIVERS_LICENSE" \
    }, \
    "name": { \
      "first_name": "John", \
      "last_name": "Smith", \
      "middle_name": "Fitzgerald", \
      "title": "Mr" \
    }, \
    "nationality": "UK" \
  }, \
  "mobile_number": "61432100100", \
  "postal_address": { \
    "city": "Melbourne", \
    "country": "AU", \
    "line1": "44 Gillespie St", \
    "line2": "Unit 2", \
    "postcode": "3121", \
    "state": "VIC" \
  } \
}'