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:
- 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.
- If required, ID documents will require an image upload. Please refer to the File Service API API to perform this
- For each new cardholder resource created, we require the
express_cardholder_consent
field 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" \
} \
}'