Ir al contenido

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.