Cardholders

Cardholder resource

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

{
    "data": {
        "id": "ch_id",
        "merchant_id": "org_id",
        "address": {
            "line1": "123 Ayala Ave",
            "line2": "Unit 10B",
            "city": "Makati",
            "state": "Metro Manila",
            "postal_code": "1226",
            "country": "PH"
        },
        "email": "[email protected]",
        "first_name": "First",
        "last_name": "Last",
        "phone": "+639123123",
        "created_at": "2026-06-22T10:48:11.65077185Z",
        "updated_at": "2026-06-22T10:48:11.65077185Z"
    }
}

Parameter	Type	Description
id	string	Id of the cardholder
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 "+639XXXXXXXXX".
created_at	timestamp	The date when the cardholder was created.
updated_at	timestamp	The date when the cardholder was updated.