> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Customer object

## The Customer object

The `Customer` object represents a payer you can reuse across payments, storing contact and tax details such as `name`, `email`, `phone`, `address`, and `tax_id`. Fintoc returns the `Customer` object in Customers API responses and in objects that reference a customer, such as `CheckoutSession` and `PaymentIntent`.

```json theme={null}
{
  "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": "acme@example.com",
  "metadata": {},
  "mode": "live",
  "name": "Acme Corp",
  "phone": "+56912345678",
  "tax_id": {
    "type": "cl_rut",
    "value": "111111111"
  }
}
```

| Attribute             | Type               | Description                                                                                                                                           |
| --------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                  | `string`           | Unique identifier, prefixed with `cus_`.                                                                                                              |
| `object`              | `string`           | Object type. Always `customer`.                                                                                                                       |
| `address`             | `object` or `null` | Postal address of the customer. See the nested `address.*` fields.                                                                                    |
| `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 of the customer, for example apartment or 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 in UTC indicating when the customer was created.                                                                                    |
| `email`               | `string`           | Email address of the customer, formatted per RFC 5322. 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`           | Environment in which the customer was created. One of `live` or `test`.                                                                               |
| `name`                | `string` or `null` | Full name of a person or the legal name of a business.                                                                                                |
| `phone`               | `string` or `null` | Phone number of the customer in E.164 format, for example `+56912345678`.                                                                             |
| `tax_id`              | `object` or `null` | Tax identifier of the customer. In Chile, a Chilean tax ID (RUT); in Mexico, a Mexican tax ID (RFC). At least one of `tax_id` or `email` is required. |
| `tax_id.type`         | `string`           | Type of tax identifier. Required when `tax_id` is provided. One of `cl_rut` (Chilean RUT) or `mx_rfc` (Mexican RFC).                                  |
| `tax_id.value`        | `string`           | Tax identifier value as a string, without dots or hyphens.                                                                                            |