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.

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

API de Fintoc

Recursos principales

API de Pagos

API de Transferencias

API de Movimientos

Direct Debit (Legacy)

API Fiscal

El objeto Customer