Objeto Client
El objeto Client representa al cliente final asociado a pagos y suscripciones de un comercio (owner).
Contiene los datos de identificación y contacto necesarios para gestionar pagos, cobros recurrentes y comunicaciones.
{ "client": { "uuid": "cli_0316825ee546f8d9", "type": "PERSONA", "first_name": "John", "last_name": "Doe", "social_id_type": 1, "social_id": "18271783-1", "email": "john@doe.cl", "phone_number": "912345678", "status": "ACTIVO", "gender_id": "Masculino", "birth_date": "1989-12-01", "created": "2025-05-15 09:38:28" }}| Atributo | Tipo | Requerido | Descripción |
|---|---|---|---|
uuid |
string | Solo respuesta | Identificador único del cliente. Formato interno cli_<alfanumérico>. |
status |
enum | Opcional (ACTIVO) |
Estado del cliente dentro del comercio. Valores: ACTIVO, BLOQUEADO. |
type |
enum | Sí | Tipo de cliente. Valores: PERSONA, EMPRESA. |
first_name |
string | Sí | Nombre del cliente. Para EMPRESA, corresponde a la razón social. |
last_name |
string | Condicional | Requerido cuando type = PERSONA. Para EMPRESA puede enviarse vacío. |
email |
string | Sí | Correo electrónico del cliente. Debe tener formato válido y es único por comercio. |
phone_number |
string | No | Teléfono de contacto. Campo opcional. |
social_id_type |
enum | No | Tipo de documento de identificación. Valores: 1 para RUT,2 para DNI. Si es RUT, se valida el formato. |
social_id |
string | No | Identificador del documento (RUT o DNI). Debe ser único por comercio. |
birth_date |
date (YYYY-MM-DD) |
No | Fecha de nacimiento del cliente. |
gender_id |
enum/string | No | Género del cliente. Valores esperados: 1 para Masculino, 2 para Femenino, 4 para Otro. |
created |
datetime | Solo respuesta | Fecha de creación del registro. |