Customer Object

{
  "id": "cus_4xKp2BanKWYnR7m",
  "object": "customer",
  "address": {
    "city": "Santiago",
    "country": "cl",
    "line1": "Av. Providencia 1234",
    "line2": "Oficina 501",
    "postal_code": "7500000",
    "state": "RM"
  },
  "created_at": "2026-03-26T20:15:30Z",
  "email": "[email protected]",
  "metadata": {},
  "mode": "live",
  "name": "Acme Corp",
  "phone": "+56912345678",
  "tax_id": "12345678-9",
  "tax_id_type": "cl_rut"
}

Attribute	Type	Description
id	string	Unique identifier for the customer. Prefixed with `cus_`.
object	string	Object type. Always `customer`.
address	object	Customer's address.
address.city	string	City of the customer
address.country	string	Two-letter country code (ISO 3166-1 alpha-2). Normalized to lowercase.
address.line1	string	Primary address line of the customer
address.line2	string	Secondary address line (e.g. apartment, suite).
address.postal_code	string	Postal or ZIP code of the customer
address.state	string	State or region of the customer
created_at	string	ISO 8601 datetime of when the customer was created.
created_at	string	ISO 8601 datetime of when the customer was updated.
email	string	Customer's email address. Normalized to lowercase. At least one of `email` or `tax_id` is required.
metadata	object	Set of key-value pairs for storing additional information.
mode	string	Either `live` or `test`.
name	string	Customer's full name or business name.
phone	string	Customer's phone number.
tax_id	objeto	Tax identifier (e.g. RUT, RFC). At least one of `tax_id` or `email` is required.
tax_id.type	string	Type of tax identifier. Required if `tax_id` is provided. Possible values include `cl_rut`, `mx_rfc`.
tax_id.value	string	Valuer of the tax ID.