Notificaciones de cambio de estado de validaciones KYC

EVENT<client-url>/users/v2/kyc/validation-status-changed

Notificaciones de cambio de estado de validaciones KYC

Deberás indicarnos este endpoint para recibir las notificaciones cuando el estado de una validación KYC de un usuario cambia. Nos deberás devolver un código HTTP del tipo 2xx para que no volvamos a enviar la notificación. Caso contrario, volveremos a enviarla.

El campo validation_result solo estará presente cuando validation_status sea COMPLETED. Los posibles resultados son SUCCESS (validación aprobada), RETRY (el usuario debe reintentar el proceso) y REJECTED (validación rechazada).

Parámetros disponibles

Header Parameters

X-Api-KeyStringrequired

X-SignatureStringrequired

X-TimestampStringrequired

X-EndpointStringrequired

Cuerpo de solicitud

application/json

idempotency_keystringrequired

event_idstringrequired

user_idstringrequired

validation_flowstringrequired

validation_statusenumrequired

validation_resultenum

validation_result_detailstring

validation_result_extra_detailstring

created_atstringdate-time

updated_atstringdate-time

Detalle de respuestas

2XX

Respuesta exitosa por parte del cliente.

4XX

Falló la respuesta. Volveremos a enviar el evento.

5XX

Falló la respuesta. Volveremos a enviar el evento.

Ejemplo de solicitud

{
  "idempotency_key": "550e8400-e29b-41d4-a716-446655440001",
  "event_id": "users_validation_status_changed",
  "user_id": "usr-203c6jQq0O3nVWXj6jRUQXy7QkC",
  "validation_flow": "global-cards",
  "validation_status": "COMPLETED",
  "validation_result": "SUCCESS",
  "created_at": "2026-01-15T10:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}

Notificaciones de cambio de estado de usuarios