SubmetryBlog

Webhooks RevenueCat : éviter les doublons de renouvellement

Empêche une relivraison de gonfler les revenus : conserve l’identifiant, enregistre la réception et teste les nouvelles tentatives.

Trois enveloppes violettes arrivent devant un filtre, une seule en ressort

Un renouvellement arrive de RevenueCat. Ton serveur l’enregistre, mais la réponse se perd. Si la prochaine livraison crée une seconde écriture, les revenus montent sur le tableau de bord sans qu’un client ait payé deux fois. Le bon test porte sur l’écriture métier, pas seulement sur la réponse HTTP.

Dédupliquer un événement, pas un abonné

RevenueCat recommande de conserver l’identifiant de l’événement pour reconnaître une nouvelle livraison du même événement. Si ton récepteur traite plusieurs intégrations indépendantes, rattache la clé à la source. L’identifiant client, lui, ne convient pas : deux renouvellements mensuels du même abonné sont deux événements.

Fais apparaître séparément les requêtes reçues et les événements distincts. Un pic de tentatives sans hausse des événements traités indique un problème de livraison à examiner, pas une hausse des ventes.

Répondre après un enregistrement durable

Vérifie la provenance de la requête selon la documentation du fournisseur. Ajoute ensuite le reçu sous une clé unique et, dans une architecture adossée à une base, inscris le travail à effectuer dans la même transaction. Une fois la transaction validée, réponds au fournisseur. Si la même clé revient avec un reçu déjà validé, accuse réception sans ajouter une deuxième tâche.

Le cas important est la coupure entre la validation et la réponse : ton système a accepté le travail, alors que le fournisseur ne le sait pas encore. Une tâche stockée seulement en mémoire n’offre pas la même garantie.

Éviter le doublon jusqu’à l’écriture finale

Une tâche peut être relancée après avoir déjà écrit dans le journal de revenus. Pose une contrainte d’unicité sur la clé d’événement dans ce journal, ou transmets cette clé à un système aval capable de la respecter. Pour les droits d’accès, vérifie aussi l’état de référence : une notification plus récente à la réception peut décrire un événement plus ancien.

Tester deux cas qui se ressemblent

En test, simule une réponse perdue puis renvoie le même renouvellement : il ne doit laisser qu’une écriture. Envoie ensuite un deuxième renouvellement fictif du même abonné avec un nouvel identifiant : il doit compter. Pour enquêter, journalise la clé et l’état de traitement plutôt que le contenu client complet.

Le guide RevenueCat de Submetry documente la déduplication et le traitement distinct du bac à sable. Si ton app est concernée, tu peux rejoindre la liste d’attente de Submetry.

Webhooks RevenueCat : éviter les doublons de renouvellement — Submetry