Airwallex logo

Creating Cardholders

The cardholder object is the resource associated with a named individual who is a representative of your business and will hold cards associated to them. Creation of cardholders involves passing our KYC (Know-Your-Customer) process and so individuals are required to present contact details as well as the details of their identifying documents.

To create a cardholder, use the Create a Cardholder 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 to determine which fields are required for your region.
  2. Certain ID documents will require an image upload. Please refer to the File Service 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": "[email protected]", \
  "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" \
  } \
}'