Livraison durable — API/SDK avancé

La séquence de boîte d’envoi et de nouvelles tentatives de cette page concerne entièrement le mode API/SDK avancé. Les marchands Stripe natifs ne doivent pas construire de boîte d’envoi AffiHQ pour les événements Stripe connectés : AffiHQ reçoit, vérifie, contrôle le mode Stripe, retente et traite ces livraisons. En cas de problème de livraison native, consultez le guide de dépannage.

Pour le mode API/SDK avancé, enregistrez chaque message destiné à AffiHQ dans votre propre base de données. Un processus de livraison peut ensuite retenter le même message jusqu’à son acceptation ou jusqu’à une erreur qui exige un examen.

Enregistrer et envoyer chaque message du mode avancé

1. Validez les données localement.
2. Insérez-les dans votre boîte d’envoi durable au cours de la même transaction que l’inscription, le Checkout ou la mise à jour du webhook.
3. Tentez éventuellement un envoi direct très court.
4. Terminez l’inscription, le Checkout ou le webhook, quelle que soit la réponse d’AffiHQ.
5. Laissez le processus de livraison reprendre les messages en attente.

Configurer la boîte d’envoi API/SDK avancée

Conservez avec chaque message une clé d’idempotence unique, le nombre de tentatives, la date de la prochaine tentative et un état de rejet définitif. Veillez à ce qu’une seule tentative de livraison soit active pour un message à la fois.

Ne recopiez pas les données dans les logs. Enregistrez seulement l’identifiant du message, le code d’erreur sans donnée sensible, l’identifiant de requête AffiHQ et le nombre de tentatives.

Nouvelles tentatives

Pour les livraisons API/SDK avancées, le SDK applique un délai exponentiel avec une part aléatoire et un plafond d’une heure. Conservez la même identité d’événement à chaque tentative. Un nouvel identifiant prestataire créerait un second fait financier au lieu de rejouer le premier.

Tester la reprise de la livraison

Avant d’activer une intégration API/SDK avancée pour vos clients, coupez la livraison vers AffiHQ puis terminez une inscription et un paiement de test. Vérifiez que les deux actions aboutissent et laissent des messages en attente. Rétablissez la livraison, puis vérifiez que les messages arrivent sans dupliquer l’attribution ni la commission.