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.

{
  "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": "[email protected]",
  "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.