Recuperar un objeto Client

Permite recuperar la información de un cliente específico mediante su uuid.

GET /v3/client/{uuid}

Ambiente	URL base API	Portal de comercio
Sandbox	https://api.virtualpos-sandbox.com	comercios.virtualpos-sandbox.com
Producción	https://api.virtualpos.cl	comercios.virtualpos.cl

Headers

Nombre	Tipo	Requerido	Descripción
Content-Type	string	No
Authorization	string	Sí	API KEY del comercio
Signature	string	Sí	Firma del mensaje

Parámetros de consulta

Nombre	Tipo	Requerido	Descripción
uuid	string	Sí	Identificador único del cliente.

Ejemplo de request

curl -X GET 'https://api.virtualpos-sandbox.com/v3/client/{uuid}?uuid=...' \
  -H 'Content-Type: application/json' \
  -H "Authorization: $API_KEY" \
  -H "Signature: $SIGNATURE"

Respuestas

200 OK

{
  "client": {
    "uuid": "cli_00183af742e91dc3",
    "status": "ACTIVO",
    "type": "PERSONA",
    "first_name": "John",
    "last_name": "Doe",
    "email": "user@example.com",
    "phone_number": "56961934502",
    "social_id_type": "RUT",
    "social_id": "12345678-9",
    "birth_date": "1990-01-01",
    "gender_id": "Masculino",
    "private_note": "Cliente recurrente de suscripciones de seguros.",
    "created": "2025-01-08 11:20:31",
    "updated": "2025-01-10 09:15:00"
  }
}

400 Bad Request

{
  "status": "NOK",
  "code": 400,
  "error": {
    "error_code": "E-###",
    "message": "detalle del error",
    "doc_url": "https://virtualpos.readme.io/reference/objeto-error"
  }
}