États des abonnements

Prev Next

Guide des états d'abonnement

Que sont les états d'abonnement ?

Les états d'abonnement indiquent précisément où se trouve un abonnement dans son cycle de vie. Considérez-les comme des mises à jour de statut qui vous aident à comprendre ce qui se passe avec l'abonnement.

Documentation API

Vous trouverez tous les états ainsi que des informations plus détaillées et techniques dans la documentation API.

Les principaux états

🟡 En attente

L'abonnement a été créé et attend d'être activé.

Ce que cela signifie :

  • L'offre d'abonnement est prête, mais pas encore active.

  • Des factures en attente peuvent être visibles ; elles seront traitées lors de l'activation.

  • Aucun service n'est encore actif.

  • Cet état est souvent configuré par le marchand avant que le client ne fournisse d'autres informations pertinentes, comme son mode de paiement.


🟢 Actif

L'abonnement est actif et peut faire l'objet d'un renouvellement automatique et d'une facturation à la demande.

Ce que cela signifie :

  • L'accès à tous les services de l'abonnement est disponible.

  • Les renouvellements automatiques sont activés.

  • La facturation s'effectue conformément au plan.

🆓 Essai

L'abonnement se trouve dans une période d'essai initiale.

❌ Résilié

L'abonnement est annulé et expirera à la fin de la période de facturation en cours.

L'annulation peut être déclenchée :

  • lors de la création de l'abonnement, en configurant une résiliation automatique ;

  • lorsque l'abonnement est déjà actif, en cliquant sur le bouton Résilier dans la fiche client.

🚫 Non renouvelable

Un abonnement peut apparaître comme non renouvelable dans les situations suivantes :

  • L'abonnement n'est ni actif ni en attente.

  • Aucune prochaine période de facturation n'est planifiée.

  • L'abonnement est annulé et va expirer.

  • L'abonnement a une date de fin définie qui a été atteinte.

  • Le plan d'abonnement prévoit un nombre limité de cycles de facturation, qui ont tous été effectués.

Les abonnements actifs disposent d'indicateurs de sous-état supplémentaires, disponibles via l'API : is_cancelled, in_trial et has_started. Pour plus de détails, consultez la documentation API.


⏸️ En pause

L'abonnement est temporairement mis en pause.

Ce que cela signifie :

  • Les services sont temporairement suspendus.

  • Aucune facturation n'a lieu pendant cette période.

  • L'abonnement peut être réactivé pour reprendre les services.

  • Lors de la réactivation, un nouveau cycle de facturation commence.


🔴 Expiré

L'abonnement a pris fin définitivement.

Ce que cela signifie :

  • Tous les services sont arrêtés.

  • L'abonnement ne peut être ni renouvelé ni réactivé.

  • Il s'agit de l'état final.


Comment les états changent-ils ?

DE

VERS

CAUSE

Nouveau

🟡 En attente

• Créé via l'API

• Créé par le client via les pages hébergées

Nouveau

🟢 Actif

• Créé via l'API

• Créé par le marchand dans l'Admin

🟡 En attente

🟢 Actif

• Créé par le client via les pages hébergées

• Créé via l'API

🟢 Actif

⏸️ En pause

• Mis en pause via l'API ou l'Admin

• Mis en pause par la procédure de relance, si l'action finale consiste à suspendre l'abonnement

⏸️ En pause

🟢 Actif

• Réactivé via l'API ou l'Admin

🟢 Actif

🔴 Expiré

• Expiré via l'API, l'Admin ou par le client dans le portail client

• Expiré par la procédure de relance, si l'action finale consiste à faire expirer l'abonnement


Événements pouvant survenir lorsque l'abonnement est actif

Même lorsque l'abonnement reste Actif, des événements importants peuvent survenir :

ÉVÉNEMENT

DESCRIPTION

subscription_payment_method_added

Un mode de paiement a été ajouté à l'abonnement pour la première fois.

subscription_payment_method_changes

Le mode de paiement a été modifié pour un abonnement disposant déjà d'un mode de paiement.

subscription_trial_end

La période d'essai de l'abonnement est terminée.

subscription_renewal

Une facture a été émise et une nouvelle période de facturation a commencé pour l'abonnement.

subscription_cancelled

L'abonnement a été annulé et expire à la fin de la période de facturation en cours.

subscription_uncancelled

Une annulation antérieure a été retirée.

subscription_changed

La planification ou la tarification de l'abonnement a été modifiée, par exemple suite à un changement de plan ou de date de début de la prochaine période.

Pour découvrir d'autres événements liés aux abonnements, consultez notre documentation API.