Cardholders

🚧
This is an early access feature.
If you would like your account to be configured, please contact [email protected]

Cardholder resource

Cardholders refer to the individuals who own the cards. A cardholder can have one or more cards.

{
  "data": {
    "id": "card_holder_v3ikTNqkhcfd4ksP8DzTQgzD",
    "type": "cardholder",
    "attributes": {
      "merchant_id": "org_D9bRRnTFHJ46yDjHeVHUHtuF",
      "address": {
        "line1": "118 Yost Turnpike",
        "line2": "Grady Alley",
        "city": "Manila",
        "state": "PH-MNL",
        "postal_code": "1000",
        "country": "PH"
      },
      "email": "[email protected]",
      "first_name": "Shayne",
      "last_name": "Kshlerin",
      "phone": "+639173742384",
      "created_at": "2025-07-03T08:07:43Z",
      "updated_at": "2025-07-03T08:07:43Z"
    }
  }
}

Parameter	Type	Description
merchant_id	string	id of the organization owning the resource.
address.line1	string	Line 1 of the cardholder's address.
address.line2	string	Line 2 of the cardholder's address.
address.city	string	City of the cardholder's address.
address.state	string	A province string as defined by the ISO_3166-2:PH spec.
address.postal_code	string	Postal code of the cardholder's address.
address.country	string	A two-letter country code in ISO 3166-1 alpha-2 format.
email	string	Email address of the cardholder.
first_name	string	First name of the cardholder.
last_name	string	Last name of the cardholder
phone	string	The PH phone number of the cardholder in the format "+63XXXXXXXXXX".
created_at	timestamp	The date when the card program was created.
updated_at	timestamp	The date when the card program was updated.