> ## 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, almacenando sus 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 referencian 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": "+56912345678",
  "tax_id": {
    "type": "cl_rut",
    "value": "111111111"
  }
}
```

| Atributo                 | Tipo       | Descripción                                                                                                                                                          |
| ------------------------ | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **id**                   | **string** | Identificador único del cliente. Prefijado con `cus_`.                                                                                                               |
| **object**               | **string** | Tipo del objeto. Siempre `customer`.                                                                                                                                 |
| **address**              | **object** | Dirección del cliente.                                                                                                                                               |
| **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 (por ejemplo, departamento o suite).                                                                                                   |
| **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 de cuándo se creó el cliente.                                                                                                                  |
| **email**                | **string** | Correo electrónico del cliente. 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** | Uno de `live` o `test`.                                                                                                                                              |
| **name**                 | **string** | Nombre completo del cliente o razón social.                                                                                                                          |
| **phone**                | **string** | Número de teléfono del cliente.                                                                                                                                      |
| **tax\_id**              | **object** | Identificador tributario del cliente. En Chile, un ID tributario chileno (RUT); en México, un ID tributario mexicano (RFC). Se requiere al menos `tax_id` o `email`. |
| **tax\_id.type**         | **string** | Formato específico por país del identificador tributario. Obligatorio cuando se proporciona `tax_id`. Uno de `cl_rut` o `mx_rfc`.                                    |
| **tax\_id.value**        | **string** | Identificador tributario normalizado, sin puntos ni guiones.                                                                                                         |