> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Relance d'abonnement

> Envoyez automatiquement des séquences d'e-mails pour récupérer les abonnements expirés ou annulés en invitant les clients à mettre à jour leur moyen de paiement.

<Info>
  La relance d'abonnement envoie automatiquement des séquences d'e-mails aux clients dont les abonnements ont expiré en raison d'un échec de paiement ou d'une annulation par le client, en les invitant à mettre à jour leur moyen de paiement et à réactiver.
</Info>

## Qu'est-ce que la relance d'abonnement ?

La relance détecte automatiquement lorsqu'un abonnement entre dans un état récupérable et envoie une séquence d'e-mails invitant le client à agir :

* **Abonnements en attente** : Échec du paiement de renouvellement (fonds insuffisants, carte expirée, etc.)
* **Abonnements annulés** : Le client a annulé depuis le portail client

## Comment fonctionne la relance

<Steps>
  <Step title="Trigger">
    La relance est déclenchée lorsque l'abonnement entre dans l'un des deux états :

    * **En attente** : Échec d'un paiement de renouvellement (fonds insuffisants, carte expirée, etc.)
    * **Annulé** : Le client a annulé son abonnement depuis le portail client
  </Step>

  <Step title="Email Sequence">
    En fonction de l'état déclencheur, le système envoie jusqu'à 4 e-mails de relance à des intervalles configurés. Chaque e-mail comprend un lien vers le portail client où le client peut mettre à jour son moyen de paiement ou racheter l'abonnement.
  </Step>

  <Step title="Recovery">
    Lorsque le client met à jour son moyen de paiement via le portail client, une charge est automatiquement créée pour les montants dus restants. Si le paiement réussit, l'abonnement est réactivé et la tentative de relance est marquée comme récupérée.
  </Step>
</Steps>

## Cycle de vie du statut

| Statut       | Description                                                                                                  |
| ------------ | ------------------------------------------------------------------------------------------------------------ |
| `recovering` | La tentative de relance est active ; des e-mails sont envoyés                                                |
| `recovered`  | Le client a mis à jour son moyen de paiement et le paiement a réussi                                         |
| `exhausted`  | Tous les e-mails ont été envoyés sans récupération, ou l'état de l'abonnement a changé de manière inattendue |

<Info>
  Lorsqu'une tentative de relance est marquée comme `exhausted`, l'état de l'abonnement n'est pas modifié. L'abonnement reste dans son état actuel (en attente ou annulé).
</Info>

## Configuration de la relance

Activez et configurez la relance depuis **Paramètres** dans votre tableau de bord.

<Frame caption="Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-settings.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=7389a9413d6008800e7ca8a5c4cd1ee5" alt="Page de paramètres de relance avec interrupteur d'activation, quatre e-mails en attente à des intervalles d'1, 3, 5 et 7 jours, et quatre e-mails annulés aux mêmes intervalles" style={{ maxHeight: '500px', width: 'auto' }} width="2250" height="1628" data-path="images/recovery/dunning-settings.png" />
</Frame>

### Séquences d'e-mails

La relance prend en charge deux séquences d'e-mails — **En attente** et **Annulé** — chacune avec jusqu'à 4 e-mails configurables.

Chaque e-mail a les champs configurables suivants :

| Paramètre      | Description                                                           |
| -------------- | --------------------------------------------------------------------- |
| **Activé**     | Activer ou désactiver individuellement les e-mails sans les supprimer |
| **Délai**      | Combien de temps après l'événement déclencheur envoyer cet e-mail     |
| **Sujet**      | Ligne d'objet de l'e-mail avec des espaces réservés                   |
| **Corps**      | Corps de l'e-mail HTML avec des espaces réservés                      |
| **Répondre à** | Adresse e-mail pour les réponses des clients                          |

**Timing par défaut des e-mails :**

| Séquence   | E-mail # | Délai par défaut |
| ---------- | -------- | ---------------- |
| En attente | 1        | 1 jour           |
| En attente | 2        | 3 jours          |
| En attente | 3        | 5 jours          |
| En attente | 4        | 7 jours          |
| Annulé     | 1        | 1 jour           |
| Annulé     | 2        | 3 jours          |
| Annulé     | 3        | 5 jours          |
| Annulé     | 4        | 7 jours          |

### Exemples d'e-mails de relance

La relance envoie différents e-mails selon l'état de l'abonnement. Voici des exemples de chaque type tels que vus par le client.

<Tabs>
  <Tab title="On Hold">
    <Frame caption="Dunning email sent when a renewal payment fails and the subscription is on hold">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-on-hold-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=5e46040ed49a4da84569afdeeb87c813" alt="E-mail de relance pour un abonnement en attente montrant le nom du magasin, un message sur l'échec du paiement, les détails de l'abonnement avec le plan et le montant, et un bouton Mettre à jour le moyen de paiement" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-on-hold-email.png" />
    </Frame>
  </Tab>

  <Tab title="Cancelled">
    <Frame caption="Dunning email sent when a customer cancels their subscription">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-cancelled-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f404fbf9415df4e4bd01562a90bd2456" alt="E-mail de relance pour un abonnement annulé montrant le nom du magasin, un message sur l'annulation, les détails de l'abonnement avec le plan et le montant, et un bouton Racheter l'abonnement" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-cancelled-email.png" />
    </Frame>
  </Tab>
</Tabs>

## Expérience de récupération client

Lorsqu'un client clique sur le lien dans un e-mail de relance, il est dirigé vers le portail client où il peut voir le statut de son abonnement et mettre à jour son moyen de paiement.

<Frame caption="Customer portal showing an on-hold subscription with option to update payment method">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/customer-recovery-page.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f498d3654afd3d70447b7b8ce7bf3767" alt="Portail client montrant un abonnement en attente pour le plan Pro à 95,00 $/an avec un bouton Mettre à jour le moyen de paiement et une bannière d'avertissement concernant l'échec du paiement" style={{ maxHeight: '500px', width: 'auto' }} width="2144" height="734" data-path="images/recovery/customer-recovery-page.png" />
</Frame>

Après que le client a mis à jour son moyen de paiement, une charge est automatiquement créée pour tout montant impayé. Si le paiement réussit, l'abonnement est réactivé immédiatement.

Pour un abonnement annulé, le client est dirigé vers une page de paiement qui a déjà l'abonnement ajouté en tant que produit.

## Analytique

Suivez la performance de la relance depuis l'onglet **Récupération** dans la section **Analytique** de votre tableau de bord.

<Frame caption="Recovery analytics dashboard showing ACR and dunning metrics">
  <img src="https://mintcdn.com/dodopayments/B3-0kuKcZDP1TiJD/images/recovery/recovery-analytics.png?fit=max&auto=format&n=B3-0kuKcZDP1TiJD&q=85&s=d3bf0c7474818bc4584b75654423e14c" alt="Tableau de bord analytique de récupération montrant le nombre d'entrées de relance, les taux de succès, les revenus récupérés, et la répartition des performances par e-mail" style={{ maxHeight: '500px', width: 'auto' }} width="2548" height="2190" data-path="images/recovery/recovery-analytics.png" />
</Frame>

| Indicateur                     | Description                                                           |
| ------------------------------ | --------------------------------------------------------------------- |
| **Entrées de relance**         | Nombre total de tentatives de relance créées                          |
| **Taux de succès**             | Pourcentage de tentatives de relance ayant conduit à une récupération |
| **Revenu récupéré**            | Total des revenus récupérés grâce à la relance                        |
| **Récupération par tentative** | Répartition des e-mails ayant conduit à la récupération               |

## Événements Webhook

| Événement           | Description                                              |
| ------------------- | -------------------------------------------------------- |
| `dunning.started`   | Une tentative de relance a été lancée pour un abonnement |
| `dunning.recovered` | Un abonnement a été récupéré grâce à la relance          |

<Card title="Recovery Webhook Payloads" icon="code" href="/developer-resources/webhooks/intents/recovery">
  Voir les schémas complets de charge utile des événements de relance.
</Card>

## Cas Limites

| Scénario                                                          | Comportement                                                                                 |
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Le client met à jour son moyen de paiement avant tout e-mail      | La récupération est détectée ; la tentative de relance est marquée comme récupérée           |
| Le client achète un autre abonnement auprès de la même entreprise | La tentative de relance est marquée comme épuisée                                            |
| Tous les e-mails de relance sont épuisés                          | La tentative de relance est marquée comme épuisée ; l'état de l'abonnement n'est pas modifié |

## Bonnes Pratiques

* **Commencez par les valeurs par défaut** : Le timing des e-mails par défaut est conçu avec un espacement raisonnable (1, 3, 5 et 7 jours) pour éviter de submerger les clients tout en maintenant l'urgence.
* **Surveillez les taux de succès** : Suivez quel e-mail dans la séquence génère le plus de récupérations. Si les e-mails ultérieurs ont une conversion proche de zéro, envisagez de les désactiver.
* **Coordonnez-vous avec le support** : Assurez-vous que votre équipe de support sait que des e-mails de relance sont envoyés, afin qu'elle puisse aider les clients qui contactent le support.
* **Examinez les états des abonnements** : Associez la relance avec les webhooks `subscription.on_hold` et `subscription.cancelled` pour un suivi complet du cycle de vie.

<Info>
  La relance fonctionne parallèlement aux flux existants d'abonnement en attente et de réactivation dans le portail client. Une fois activée, elle fonctionne automatiquement sans intégration supplémentaire requise.
</Info>

## Associé

<CardGroup cols={2}>
  <Card title="Recovery Webhooks" icon="webhook" href="/developer-resources/webhooks/intents/recovery">
    Réagissez aux événements `dunning.started` et `dunning.recovered`.
  </Card>

  <Card title="Abandoned Cart Recovery" icon="cart-shopping" href="/features/recovery/abandoned-cart-recovery">
    Récupérez les paiements uniques incomplets ou échoués avec des e-mails ciblés.
  </Card>

  <Card title="Customer Portal" icon="id-card" href="/features/customer-portal">
    Les clients mettent à jour les moyens de paiement via le portail client.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    Comprenez les états d'abonnement qui déclenchent les flux de travail de relance.
  </Card>
</CardGroup>
