> For the complete documentation index, see [llms.txt](https://docs.flycode.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flycode.com/docs/fr/integrations/stripe-integration-guide-for-flycode.md). # Guide d’intégration Stripe : connectez FlyCode à Stripe Billing {% hint style="info" %} **TL;DR :** Installez l’application FlyCode vérifiée depuis la Stripe App Marketplace, configurez les paramètres de relance et de récupération par e-mail de Stripe de sorte qu’ils n’entrent pas en concurrence avec FlyCode, puis activez l’application. Aucun code, aucun point de terminaison de webhook à créer. FlyCode relance ensuite les factures d’abonnement échouées via l’API Stripe avec un timing piloté par machine learning par marchand, et chaque action apparaît dans votre tableau de bord Stripe. La configuration prend moins d’une heure ; le modèle s’ajuste tout seul au cours des 6 à 8 premières semaines. {% endhint %} ## À 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](https://docs.flycode.com/docs/integrations/supported-payment-and-subscription-platforms). ## En quoi FlyCode diffère de la récupération intégrée de Stripe {% embed url="" %} 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](https://docs.flycode.com/docs/stripe-smart-retries-complete-guide). ## 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](https://www.flycode.com/get-started); 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 {% stepper %} {% step %} ### Installez l’application FlyCode Ouvrez l’ [application FlyCode sur la Stripe App Marketplace](https://marketplace.stripe.com/apps/flycode-payments) 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. {% endstep %} {% step %} ### Configurez les paramètres de relance de Stripe Rendez-vous sur [Revenue recovery, Retries](https://dashboard.stripe.com/revenue-recovery/retries) et apportez ces modifications dans cet ordre. 1. **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.

onglet Revenue recovery, Retries : statut après récupération échouée

2. **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.

onglet Revenue recovery, Retries : relances par carte personnalisées

3. **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.

onglet Revenue recovery, Retries : ACH

{% endstep %} {% step %} ### Configurez les paramètres d’e-mail de Stripe Rendez-vous sur [Revenue recovery, Emails](https://dashboard.stripe.com/revenue-recovery/emails). 1. **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. 2. **E-mails d’échec de débit ACH :** si vous acceptez ACH, laissez-les activés. 3. **E-mails de rappel de carte :** laissez les e-mails de rappel de carte de Stripe activés.

onglet Revenue recovery, Emails : paiements échoués

onglet Revenue recovery, Emails : rappels de carte

{% endstep %} {% step %} ### 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. {% endstep %} {% endstepper %} ## 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.

Architecture FlyCode

### 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. | Action | Appel API Stripe | Quand | Ce que vous voyez dans Stripe | | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | Marquer une facture comme en récupération | [Mettre à jour la facture](https://docs.stripe.com/api/invoices/update) : 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 | [Payer la facture](https://docs.stripe.com/api/invoices/pay) | 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](https://docs.stripe.com/api/subscriptions/cancel), 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](https://docs.stripe.com/api/invoices/void) ou [Marquer comme irrécouvrable](https://docs.stripe.com/api/invoices/mark_uncollectible), 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. {% hint style="info" %} **Protection :** un abonnement n’est jamais annulé si une facture créée après celle devenue irrécouvrable a été payée. Un abonnement redevenu sain par d’autres moyens reste actif. {% endhint %} {% hint style="info" %} **Recommandé :** les étapes d’annulation et de nettoyage des factures sont facultatives mais activées par défaut. Les laisser activées empêche de nouvelles tentatives sur les factures perdues et maintient des statuts d’abonnement et de facture exacts pour vos clients et vos rapports. {% endhint %}

Journal des événements de facture montrant la mise à jour des métadonnées FlyCode

Page de facture après une relance FlyCode réussie

Vue des paiements : la relance est une nouvelle charge sous l’intention de paiement d’origine

Page d’abonnement après annulation par FlyCode

### 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](https://help.flycode.com/failed-payment-outreach). ## Liste de contrôle avant mise en production * [ ] Application FlyCode installée et autorisations confirmées * [ ] Relances Stripe : statut après récupération échouée défini sur « laisser en impayé » * [ ] Relances Stripe : relances par carte définies sur Personnalisé, 3 relances, intervalle de 7 jours * [ ] Relances Stripe : relances ACH laissées activées (si applicable) * [ ] E-mails Stripe : e-mails de paiement échoué par défaut désactivés (si FlyCode envoie des notifications) * [ ] E-mails Stripe : e-mails de débit ACH échoué activés (si applicable), e-mails de rappel de carte activés * [ ] FlyCode : mode de relance et préférence de notification définis ; enregistrements SPF et DKIM ajoutés si FlyCode envoie des e-mails * [ ] Application FlyCode activée ## À quoi s’attendre après la mise en ligne **Factures ouvertes en récupération.** Dans Stripe, ouvrez Factures et appliquez [ce filtre](https://dashboard.stripe.com/invoices?status=open\&total\[gt]=0\&type=subscription) (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.

Liste filtrée des factures avec la colonne FlyCode Recovery

**Taux de recouvrement.** Continuez à utiliser [le tableau de bord Revenue Recovery de Stripe](https://dashboard.stripe.com/revenue-recovery). 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.

Tableau de bord Stripe Revenue Recovery

**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.

Info-bulle du tableau de bord Revenue Recovery pour « En récupération »

## 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](https://www.flycode.com/get-started). ## 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 ?](https://help.flycode.com/flycode-and-stripe/going-further-with-flycode) ## Connexe * [FlyCode et Stripe](https://help.flycode.com/flycode-and-stripe) dans le centre d’aide * [Comment gérer les paiements échoués dans Stripe](https://docs.flycode.com/docs/integrations/how-to-manage-failed-payments-in-stripe) * [Guide des codes de refus de paiement d’abonnement pour Stripe](https://docs.flycode.com/docs/subscription-payment-decline-codes-guide-for-stripe) * [Référence des codes de refus Stripe](https://www.flycode.com/stripe/decline-codes) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.flycode.com/docs/fr/integrations/stripe-integration-guide-for-flycode.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.