Aller au contenu principal

Stratégie de repli

En cas d'indisponibilité du service webhook, il est recommandé d'implémenter un mécanisme de repli pour garantir que votre application puisse récupérer le résultat du processus dans le délai de réponse attendu.

Fonctionnement

Le webhook est le mécanisme principal de livraison des résultats. Cependant, vous devez traiter les signaux suivants comme des déclencheurs supplémentaires pour récupérer activement le résultat via GET /client/v1/process/{processId} :

SignalCanalCe qu'il fournit
Callback onFinishSDK Web / WebMobileSignal de fin de parcours — sans résultat
Redirection callbackUriTous les autres canauxRedirection URL uniquement — sans résultat
avertissement

Ni onFinish ni callbackUri ne transmettent directement le résultat du processus. Ce sont uniquement des signaux de fin de parcours. Votre back-end est responsable de la corrélation entre l'id reçu (ou la redirection) et le processId précédemment stocké, puis d'appeler GetProcess pour récupérer le résultat réel.

Flux recommandé

Dès réception d'un signal de fin de parcours, votre back-end doit appeler GET /client/v1/process/{processId} et valider le résultat dans l'ordre suivant :

  1. Confirmer state = PROCESS_STATE_FINISHED
  2. Évaluer le champ result et appliquer vos règles métier

Cela garantit qu'une indisponibilité temporaire du webhook n'entraîne pas la perte des résultats du processus.