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.

JSON

{
    "client": {
        "uuid": "cli_0316825ee546f8d9",
        "type": "PERSONA",
        "first_name": "John",
        "last_name": "Doe",
        "social_id_type": 1,
        "social_id": "18271783-1",
        "email": "[email protected]",
        "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.