Menu

L'objet subscription

Cet objet vous permet de créer facilement des abonnements en décidant de la fréquence, durée, devise et modèle de souscription. Il vous permet d’associer un ou plusieurs abonnements à un client, d’enregistrer une ou plusieurs cartes par client et d’assurer la continuité de l’abonnement même en cas de changement ou d’expiration de la carte.

Vous pouvez par exemple gérer des échéanciers réguliers, des plans d’abonnement à l’usage ou pay-as-you-go, des paiements ponctuels en plus de l’abonnement.

Concrètement, l’objet subscription vous permet donc de définir des cycles de paiements récurrents sous forme d’abonnement sur un de vos customer. Ils se définissent en paramétrant un subscriptionModel.

Les subscriptionModel sont, quant à eux, des objets représentant un coût, une devise et un cycle de facturation ensemble.

Vous pouvez définir un ou plusieurs subscriptionModel, selon la gamme de services et de produits que vous offrez.

Définitions utiles pour cette section :

  • SubscriptionModel : modèle ou plan d’abonnement
  • Abonnement : abonnement appliqué à un client et suite à un SubscriptionModel
  • Facture : option à utiliser si vous devez modifier la valeur à l’intérieur d’un plan d’abonnement
  • InvoiceItem : ligne ou article inclus dans la facture. Une facture a potentiellement plusieurs lignes ou éléments

Exemple :

Vous avez la possibilité de facturer à votre client 10 € tous les 3 mois à 4 reprises, en commençant le 05/07/2023 et en finissant le 05/04/2024, ce qui correspond à un abonnement d'un an.

Field Value
amount 10,00 €
intervalUnit MONTH
intervalCount 3
iterationCount 4
startingDate 05/07/2023

Le résultat sera :

Date Amount Detail
05/07/2023 10,00 € Iteration 1
05/10/2023 10,00 € Iteration 2
05/01/2024 10,00 € Iteration 3
05/04/2024 10,00 € Iteration 4