Guide d'intégration Stripe : connecter FlyCode à Stripe Billing
Connectez FlyCode à Stripe Billing étape par étape : prérequis, installation de l'application Stripe vérifiée, paramètres de nouvelles tentatives et d'email à modifier, appels API, checklist de mise en production.
À qui cela s’adresse
Entreprises par abonnement facturant via Stripe Billing (abonnements et factures) et souhaitant récupérer davantage de paiements échoués que Stripe Smart Retries seul. Si vous facturez via Shopify, Recharge, Skio, Braintree ou PayPal, voir Plateformes de paiement et d’abonnement prises en charge.
En quoi FlyCode diffère de la récupération intégrée de Stripe
Stripe Smart Retries applique une stratégie de relance unique entraînée sur tous les marchands Stripe et limite les tentatives à 8 par facture. FlyCode entraîne un modèle sur vos propres transactions et les réponses des émetteurs, choisit le moment de relance pour chaque facture, coordonne les e-mails avec les relances au lieu d’envoyer un e-mail à chaque tentative, et peut débiter une carte de secours enregistrée. Les marchands récupèrent généralement environ 20 % de paiements échoués en plus, soit une hausse de 5 à 9 % de l’ARR. Détails : Guide complet de Stripe Smart Retries.
Prérequis
Un compte Stripe utilisant Stripe Billing pour les abonnements, avec l’autorisation d’installer des applications (rôle Administrateur ou Développeur).
Accès aux paramètres de Revenue Recovery de Stripe (Paramètres, Facturation, Revenue recovery).
Un compte FlyCode. Si vous n’en avez pas encore, commencez ici; l’installation depuis la marketplace lance également le processus d’inscription.
Optionnel : si vous souhaitez que FlyCode envoie les e-mails de récupération depuis votre domaine, la possibilité d’ajouter des enregistrements DNS SPF et DKIM pour un sous-domaine d’envoi.
Configuration
Installez l’application FlyCode
Ouvrez l’ application FlyCode sur la Stripe App Marketplace et cliquez sur Installer. Vérifiez et confirmez les autorisations affichées par Stripe : FlyCode lit les clients, abonnements, factures, intents de paiement et charges, et écrit les métadonnées de facture, les paiements de facture et le statut d’abonnement. Rien d’autre. Lors de l’installation, FlyCode charge chaque facture actuellement en erreur afin que la récupération commence sur votre portefeuille existant d’échéances impayées, et pas uniquement sur les nouveaux échecs.
Configurez les paramètres de relance de Stripe
Rendez-vous sur Revenue recovery, Retries et apportez ces modifications dans cet ordre.
Statut de l’abonnement et de la facture après une récupération échouée : définir sur « laisser en impayé » . Cela permet à FlyCode de gérer les statuts après récupération sans que Stripe n’annule les abonnements selon son propre calendrier.
Relances par carte : choisissez « Personnalisé » et définissez 3 relances avec un intervalle de 7 jours, pour une période maximale de récupération de 7 jours. Cela limite au minimum les relances propres à Stripe afin que le moteur de FlyCode contrôle le timing des relances.
Relances ACH : si vous acceptez ACH, laissez l’option de relance ACH activée. La récupération par carte de FlyCode ne remplace pas les relances de débit bancaire de Stripe.
Configurez les paramètres d’e-mail de Stripe
Rendez-vous sur Revenue recovery, Emails.
E-mails d’échec de paiement : si vous utilisez les notifications de récupération de FlyCode (recommandé), désactivez les e-mails de récupération de paiement par défaut de Stripe afin que les clients ne reçoivent pas deux séries de messages.
E-mails d’échec de débit ACH : si vous acceptez ACH, laissez-les activés.
E-mails de rappel de carte : laissez les e-mails de rappel de carte de Stripe activés.
Définissez les préférences FlyCode et activez
Dans FlyCode, confirmez deux préférences : le mode de relance (conservez l’échéancier par défaut piloté par le modèle sauf raison contraire) et le fait que FlyCode envoie ou non les e-mails de récupération en votre nom. Si c’est le cas, ajoutez les enregistrements SPF et DKIM fournis par FlyCode afin que les messages soient authentifiés depuis votre domaine. Puis activez l’application. FlyCode commence immédiatement à traiter les factures échouées ouvertes.
Comment fonctionne l’intégration
L’application FlyCode connecte votre compte Stripe au moteur de récupération de FlyCode. Elle écoute les événements webhook Stripe pour obtenir des mises à jour en temps réel sur les abonnements et les paiements, transmet les données pertinentes au moteur et exécute les décisions du moteur via l’API Stripe. Tout est exécuté de manière transparente et reflété dans votre tableau de bord Stripe.
Ce que lit FlyCode : événements webhook
L’application s’abonne uniquement aux événements Stripe nécessaires à la récupération et à la gestion des abonnements : événements de facture (créée, finalisée, paiement échoué, payée, mise à jour), événements d’intention de paiement et de charge (paiement échoué, réussi), et événements client et abonnement (créé, mis à jour, supprimé). Ceux-ci fournissent au moteur le code de refus, les détails de la carte et de l’émetteur, ainsi que l’historique du compte dont il a besoin pour programmer chaque relance. L’application utilise son propre abonnement d’événements au périmètre de l’application et ne touche pas aux points de terminaison webhook créés par votre équipe ou par d’autres applications.
Ce que FlyCode écrit : appels API Stripe
Ce sont les seuls appels d’écriture (POST) effectués par l’application FlyCode. Chacun est consigné dans le portail développeur Stripe et visible sur l’objet concerné dans le tableau de bord.
Marquer une facture comme en récupération
Mettre à jour la facture : ajoute des métadonnées flycode_recovery: true
Lorsqu’une facture d’abonnement échouée entre en récupération
Champ de métadonnées sur la page de la facture ; entrée Mettre à jour la facture dans le journal des événements de la facture
Relancer une facture échouée
Lorsque le moteur décide du moment de relance
Entrée dans les activités récentes de la facture ; nouvelle charge sous l’intention de paiement d’origine (aucun objet de paiement supplémentaire)
Annuler un abonnement irrécupérable (optionnel, activé par défaut)
Annuler l’abonnement, avec cancellation_details
Après le nombre maximal de tentatives sans succès
Abonnement affiché comme annulé avec l’événement d’annulation
Clore la facture non recouvrée (optionnel, activé par défaut)
Annuler la facture ou Marquer comme irrécouvrable, selon votre préférence
Au même moment que l’annulation ; appliqué aussi aux factures ouvertes ultérieures du même abonnement
Statut de la facture annulé ou irrécouvrable avec l’événement consigné
Avant chaque écriture, l’application relit l’état actuel de l’objet Stripe. Si une facture a déjà été payée, annulée ou invalidée par un autre système, FlyCode n’effectue aucune action. Cela rend l’intégration idempotente et évite les doubles prélèvements ou les conflits de statut.
E-mails de récupération
Pour de meilleurs résultats et une expérience de marque cohérente, désactivez les e-mails de récupération par défaut de Stripe et utilisez les notifications FlyCode. Elles sont déclenchées par le moteur en synchronisation avec le calendrier de relance (pas d’e-mail après un refus temporaire lorsqu’une relance a encore de bonnes chances d’aboutir), envoyées depuis votre propre domaine dans la langue de votre marque, et programmées selon les heures locales du client. Voir Relance des paiements échoués.
Liste de contrôle avant mise en production
À quoi s’attendre après la mise en ligne
Factures ouvertes en récupération. Dans Stripe, ouvrez Factures et appliquez ce filtre (statut ouvert, factures d’abonnement, total supérieur à zéro). Cliquez sur « Modifier les colonnes » et ajoutez « FlyCode Recovery (métadonnées) » pour voir l’indicateur de récupération sur chaque ligne.
Taux de recouvrement. Continuez à utiliser le tableau de bord Revenue Recovery de Stripe. Les factures récupérées par FlyCode y apparaissent comme récupérées ; l’affichage de Stripe ne change pas. Le tableau de bord propre à FlyCode ajoute la récupération par code de refus, la vitesse de récupération, le nombre de tentatives par facture récupérée et le revenu récupéré par rapport à votre référence avant FlyCode.
Chronologie. Le moteur a généralement besoin de 6 à 8 semaines pour optimiser son modèle pour votre clientèle ; la récupération s’améliore pendant cette période. La fonction « Go Back in Time » de FlyCode réexamine également les factures ayant échoué jusqu’à environ 60 jours avant l’activation, de sorte que les taux de récupération des mois précédents peuvent augmenter après la mise en production.
Le chiffre « En récupération » de Stripe. Dans la répartition Revenue Recovery, Stripe définit « En récupération » selon la durée maximale de relance personnalisée que vous avez définie (7 jours), et non selon la véritable fenêtre de récupération de FlyCode ; cette section orange sous-estime donc le nombre de factures que FlyCode traite encore. Utilisez le filtre de facture ci-dessus ou le tableau de bord FlyCode pour obtenir un chiffre exact.
Dépannage
Les clients ont reçu deux e-mails au sujet du même paiement échoué. Les e-mails de récupération par défaut de Stripe sont toujours activés. Désactivez-les dans Revenue recovery, Emails (Étape 3), ou configurez FlyCode en mode relances uniquement si vous souhaitez que Stripe ou un autre outil gère la messagerie.
Stripe relance toujours selon son propre calendrier. Les relances par carte ne sont pas définies sur Personnalisé, 3 relances à intervalles de 7 jours (Étape 2). Deux moteurs de relance sur une même carte peuvent dépasser les limites de tentatives des réseaux de cartes et réduire les taux d’autorisation.
Un abonnement a été annulé après l’épuisement des tentatives de FlyCode, et nous ne nous y attendions pas. Les étapes d’annulation et de nettoyage des factures sont activées par défaut. Désactivez-les dans FlyCode si vous préférez conserver les abonnements non recouvrés en impayé, et notez que la protection empêche déjà l’annulation lorsqu’une facture ultérieure a été payée.
Une facture n’affiche pas les flycode_recovery métadonnées. Seules les factures d’abonnement échouées entrent en récupération ; les factures ponctuelles et celles ayant échoué avant la fenêtre de rattrapage de l’application ne sont pas étiquetées. Vérifiez que la facture est bien une facture d’abonnement au statut ouvert avec un échec de paiement, et que l’application est activée.
Le taux de récupération dans Stripe semble inchangé au cours des premières semaines. Le modèle est dans sa période d’optimisation de 6 à 8 semaines, et le tableau de bord Stripe attribue les factures récupérées sans distinguer celles de FlyCode. Comparez avec votre base de référence dans le tableau de bord FlyCode, qui est celui utilisé pour la facturation basée sur les résultats.
Le montant « En récupération » dans Stripe semble trop faible. Attendu ; voir la note ci-dessus sur la manière dont Stripe le définit.
Toujours bloqué ? Envoyez un e-mail au support ou réservez un créneau avec l’équipe.
FAQ
FlyCode a-t-il besoin de temps d’ingénierie ? Non. L’installation se fait via une application Stripe ; les seules étapes manuelles sont les paramètres Stripe ci-dessus. La plupart des marchands sont en ligne en moins d’une heure.
FlyCode interférera-t-il avec mes webhooks ou applications existants ? Non. Il utilise son propre abonnement d’événements au niveau de l’application, ne modifie jamais vos points de terminaison webhook, les règles Radar ou d’autres applications, et revérifie l’état de l’objet avant chaque écriture.
FlyCode touche-t-il aux fonds ? Non. Les relances sont des appels Payer la facture via votre compte Stripe ; les revenus récupérés sont ensuite crédités normalement sur votre solde Stripe.
Puis-je laisser Stripe Smart Retries activé ? Vous gardez la fonctionnalité de relance de Stripe techniquement activée, mais réduite au minimum selon le calendrier personnalisé de l’étape 2 afin que FlyCode contrôle le timing. Faire fonctionner les deux en parallèle à pleine capacité gaspille des tentatives.
Qu’advient-il des factures qui échouaient déjà avant mon installation ? Elles sont rattrapées lors de l’installation et entrent en récupération ; la fonction Go Back in Time couvre environ les 60 jours précédents.
Comment FlyCode est-il tarifé sur Stripe ? Basé sur les résultats : une part du revenu récupéré au-dessus de votre base de référence, rien sur ce que Stripe aurait de toute façon récupéré. Voir Comment FlyCode est-il tarifé pour les utilisateurs de Stripe ?
Connexe
FlyCode et Stripe dans le centre d’aide
Mis à jour
Ce contenu vous a-t-il été utile ?