AAPDÓrdenes
Validar identidad del cliente
POST /orders/{hash}/validate_customer_identity — usado por el widget.
POST /orders/{order_hash}/validate_customer_identity
Authorization: Bearer {client_id}
Content-Type: application/jsonEl widget llama a esto en tu nombre. No tienes que implementarlo — esta página documenta lo que está pasando para que puedas debuggear.
El widget envía el RUT del paciente y el número de serie de su CI a Ventipay para verificación de identidad. Ventipay devuelve éxito/falla de forma síncrona.
Cuerpo de la request
{
"rut": "12345678-9",
"ci_serial": "A123456789"
}| Campo | Obligatorio | Notas |
|---|---|---|
rut | sí | El mismo RUT con el que se creó la orden. |
ci_serial | sí | Número de serie del documento CI (impreso en la cédula). |
Respuesta (200 OK)
{
"success": true,
"message": "Identity validated successfully"
}Errores
| Status | Causa |
|---|---|
| 400 | El RUT no coincide con el customer de la orden, o formato de CI inválido. |
| 401 | client_id faltante o inválida. |
| 404 | Orden no encontrada. |
| 422 | Ventipay rechazó la identidad (mismatch con registros nacionales). |
Si la llamada falla, el widget mantiene al paciente en la pantalla de validación de identidad y le ofrece reintentar. Desde tu lado, la única consecuencia es que el paciente nunca llega a la pantalla de pago.