Aller au contenu principal

Introduction

Le module Subscriptions permet de configurer dans le projet des paiements récurrents des utilisateurs pour un ensemble fixe de produits. Une souscription se compose d'un ensemble de produits et d'une période — tous les N jours, le coût, calculé comme la somme des prix des produits inclus, est automatiquement (ou manuellement) prélevé sur l'utilisateur.

Le module se compose de deux parties principales :

  • Le module "Subscriptions" dans le menu de gauche — un catalogue de toutes les souscriptions du projet. Ici, vous créez, éditez et supprimez des souscriptions, configurez leur compte de paiement, leur période et la composition des produits. Pour plus de détails — dans la section des paramètres des souscriptions.
  • L'onglet "Subscriptions" dans la fiche utilisateur — une liste des souscriptions d'un utilisateur spécifique avec des statuts, des dates d'expiration et des actions manuelles (pour les souscriptions de type custom). Pour plus de détails — dans la section des souscriptions de l'utilisateur.

Le travail avec les souscriptions du côté de l'application cliente se fait via l'API. Pour plus de détails — dans la section API des souscriptions.

Comment fonctionne la souscription​

Lors de la création d'une souscription dans l'admin, vous choisissez :

  • Compte de paiement — détermine comment le paiement sera effectué. Pour plus de détails sur les types de comptes — dans la section des comptes de paiement.
  • Période en jours — tous les combien de jours l'utilisateur doit effectuer un paiement pour renouveler la souscription.
  • Liste des produits inclus dans la souscription — leur prix actuel constitue le coût total de la souscription.

Lorsque l'utilisateur souscrit via l'API, le système :

  1. Crée un enregistrement de souscription pour l'utilisateur.
  2. Renvoie un lien de paiement (pour stripe et midtrans) ou active immédiatement la souscription pour le type custom.
  3. À la fin de la période, prélève automatiquement le prochain paiement (stripe, midtrans) ou attend un renouvellement manuel (custom).

Comptes de paiement pris en charge​

Vous pouvez connecter l'une des types de comptes de paiement suivants à la souscription :

  • Stripe — prélèvements périodiques automatiques via Stripe. Après la création de la souscription, l'API renvoie un lien pour le paiement initial.
  • Midtrans — prélèvements périodiques automatiques via Midtrans. De manière similaire à Stripe, un lien de paiement est renvoyé.
  • Custom — souscription manuelle. Les prélèvements ne sont pas effectués automatiquement ; le renouvellement et l'annulation sont effectués par l'administrateur depuis la fiche utilisateur.
info

Le type de compte de paiement détermine quelles actions sont disponibles sur la souscription et si elle peut être annulée via l'API. Les souscriptions custom ne peuvent être annulées que via l'admin — dans la section de l'utilisateur.

Dynamique des coûts​

Le coût de la souscription est calculé comme la somme des prix des produits qui la composent. Si vous modifiez le prix d'un des produits, les souscriptions actives recalculeront automatiquement leur coût — la nouvelle valeur sera appliquée à partir de la prochaine période de prélèvement.

info

La période actuelle est toujours payée au prix en vigueur au moment de son début. Cela permet de modifier la composition et les prix des produits sans perturber les périodes déjà payées par l'utilisateur.