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 CardholdersManage Cardholders
View Transactions
Merchant Category Codes

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 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" \
  } \
}'