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.

{
  "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.

API de Fintoc

Recursos principales

API de Pagos

API de Transferencias

API de Movimientos

Direct Debit (Legacy)

API Fiscal

El objeto Customer