Airwallex logo

Manage Cardholders

Cardholder management APIs allow you to manage the named individuals in your organisation who hold cards. These APIs only allow you to modify the cardholder resources; to modify cards associated with a cardholder, pass the cardholder_id into the Manage a Cardholder API .

Sample Request

You can update a cardholder at any time with selected information. Please note - changing anything in the individual field will re-trigger the KYC process (If applicable).

--url 'https://pci-api-demo.airwallex.com/api/v1/issuing/cardholders/6c2dc266-09ad-4235-b61a-767c7cd6d6ea/update' \
--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" \
  }, \
  "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" \
  } \
}'