Estrategia de Fallback
En caso de cualquier indisponibilidad en el servicio de webhook, se recomienda implementar un mecanismo de fallback para garantizar que tu aplicación pueda recuperar el resultado del proceso dentro del tiempo de respuesta esperado.
Cómo funciona
El webhook es el mecanismo principal de entrega de resultados. Sin embargo, debes tratar las siguientes señales como disparadores adicionales para obtener el resultado activamente a través de GET /client/v1/process/{processId}:
| Señal | Canal | Lo que proporciona |
|---|---|---|
Callback onFinish | SDK Web / WebMobile | Señal de fin de jornada — sin resultado |
Redirección callbackUri | Todos los demás canales | Solo redirección de URL — sin resultado |
Ni onFinish ni callbackUri entregan el resultado del proceso directamente. Son únicamente señales de fin de jornada. Tu back-end es responsable de correlacionar el id recibido (o la redirección) con el processId previamente almacenado, y luego llamar a GetProcess para recuperar el resultado real.
Flujo recomendado
Una vez recibida una señal de fin de jornada, tu back-end debe llamar a GET /client/v1/process/{processId} y validar el resultado en el siguiente orden:
- Confirmar
state = PROCESS_STATE_FINISHED - Evaluar el campo
resulty aplicar tus reglas de negocio
Esto garantiza que la indisponibilidad temporal del webhook no resulte en la pérdida de los resultados del proceso.