​

Nombre d’appels HTTP envoyés

La destination d’un webhook peut recevoir plusieurs appels HTTP pour un même événement, selon l’événement.

À chaque fois qu’une transaction arrive dans un statut final comme failed ou success, le webhook concerné ne devrait être envoyé qu’une seule fois.

Par contre pour les statuts intermédiaires comme pending ou action_required, il peut y avoir plusieurs appels HTTP. Cela arrive si les données de l’opérateur ont changé, cela signifie que l’API HUB2 a reçu une mise à jour du côté de l’opérateur mais cette mise à jour est insuffisante pour déterminer le statut final de la transaction.

​

En cas d’échec HTTP

Dans le cas où l’URL distante n’est pas joignable pour n’importe quelle raison (échec réseau, indisponibilité du serveur, …), l’appel HTTP va échouer.

Pour pallier cette éventualité, l’API HUB2 dispose d’une stratégie de re-jeu.

​

Stratégie de re-jeu

En cas d’échec, un webhook est “rejoué” après un délai de 60 secondes. Chaque tentative allonge ce délai de manière exponentielle suivant ce morceau de code:

exponential(delay) {
	return function(attemptsMade) {
		return Math.round((Math.pow(2, attemptsMade) - 1) * delay);
	};
}

Exemple de délais pour chaque Nième tentative:

1. Attente de 1 minute
2. Attente de 3 minutes
3. Attente de 7 minutes
4. Attente de 15 minutes
5. Attente de 31 minutes
6. Attente de 63 minutes
7. Attente de 127 minutes
8. etc..

​

Timeout

Si un tel scénario devait arriver, cela déclenchera la stratégie de re-jeu et peut représenter une cause pour laquelle plusieurs fois le même webhook est reçu.

​

Désactivation automatique

Cette désactivation n’est que temporaire et vise à garder une qualité de service constante de l’API HUB2. Toutefois, afin d’éviter tout souci de qualité d’intégration, il est préférable que cela n’arrive jamais.

Il est possible de réactiver le webhook à tout moment via l’API mise à disposition.

Afin de s’assurer que cette désactivation n’ait pas lieu, le point de terminaison cible au webhook doit toujours retourner un code HTTP 2xx.

Toute autre réponse, ou aucune réponse, sera considérée comme une erreur, et après plusieurs essais, désactivera le webhook automatiquement.