> ## 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.

# El objeto Customer

El objeto `Customer` representa a un pagador que puedes reutilizar en distintos pagos. El objeto almacena datos de contacto y tributarios, como `name`, `email`, `phone`, `address` y `tax_id`. Fintoc devuelve el objeto `Customer` en las respuestas de la API de Customers y en objetos que hacen referencia a un cliente, como `CheckoutSession` y `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": "+56911111111",
  "tax_id": {
    "type": "cl_rut",
    "value": "111111111"
  }
}
```

El objeto `Customer` tiene los siguientes atributos:

| Atributo              | Tipo              | Descripción                                                                                                                                                                                                        |
| --------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`                  | `string`          | Identificador único, prefijado con `cus_`.                                                                                                                                                                         |
| `object`              | `string`          | Tipo del objeto. Siempre `customer`.                                                                                                                                                                               |
| `address`             | `object` o `null` | Dirección postal del cliente. Ver los campos anidados `address.*`.                                                                                                                                                 |
| `address.city`        | `string`          | Ciudad del cliente.                                                                                                                                                                                                |
| `address.country`     | `string`          | Código de país de dos letras (ISO 3166-1 alpha-2). Normalizado a minúsculas.                                                                                                                                       |
| `address.line1`       | `string`          | Primera línea de la dirección del cliente.                                                                                                                                                                         |
| `address.line2`       | `string`          | Segunda línea de la dirección del cliente, como un departamento o una oficina.                                                                                                                                     |
| `address.postal_code` | `string`          | Código postal del cliente.                                                                                                                                                                                         |
| `address.state`       | `string`          | Estado o región del cliente.                                                                                                                                                                                       |
| `created_at`          | `string`          | Fecha y hora ISO 8601 en UTC en que se creó el cliente.                                                                                                                                                            |
| `email`               | `string`          | Correo electrónico del cliente, con formato RFC 5322. Normalizado a minúsculas. Se requiere al menos `email` o `tax_id`.                                                                                           |
| `metadata`            | `object`          | Conjunto de pares clave-valor para almacenar información adicional.                                                                                                                                                |
| `mode`                | `string`          | Ambiente en el que se creó el cliente. Uno de `live` o `test`.                                                                                                                                                     |
| `name`                | `string` o `null` | Nombre completo de una persona o la razón social de una empresa.                                                                                                                                                   |
| `phone`               | `string` o `null` | Número de teléfono del cliente en formato E.164, por ejemplo `+56911111111`.                                                                                                                                       |
| `tax_id`              | `object` o `null` | Identificador tributario del cliente. En Chile, corresponde al identificador tributario chileno (RUT). En México, corresponde al identificador tributario mexicano (RFC). Se requiere al menos `tax_id` o `email`. |
| `tax_id.type`         | `string`          | Tipo de identificador tributario. Obligatorio cuando se proporciona `tax_id`. Uno de `cl_rut` (RUT chileno) o `mx_rfc` (RFC mexicano).                                                                             |
| `tax_id.value`        | `string`          | Identificador tributario sin puntos ni guiones.                                                                                                                                                                    |