Commencer

Flux d'intégration

Pour intégrer Subscriptions :

  1. Créez un projet pour votre jeu.
  2. Configurez des plans d’abonnement.
  3. Configurez l’autorisation.
  4. Créez une interface de catalogue.
  5. Configurez l’ouverture de l’interface de paiement.
  6. Implémentez l’obtention des informations d’abonnement.
  7. Signez le contrat de licence.

Comment ça marche

Achat d’un abonnement

Renouvellement automatique de l’abonnement récurrent

Flux utilisateur

Glossaire

Plan d'abonnement
Conditions de facturation (montant de facturation, devise et fréquence) sur la base desquelles l’utilisateur obtient son accès au service. La configuration d’un plan est une étape d’intégration obligatoire.
Produit par abonnement

Service ou ensemble de services fournis à l’utilisateur lors de l’achat d’un abonnement. L’appel API Créer un produit est utilisé pour créer ces produits. La création de produits par abonnement est nécessaire lorsque vous configurez la vente d’abonnements distincts pour différents services ou si vous souhaitez permettre à l’utilisateur de souscrire plusieurs abonnements en même temps. Un produit par abonnement peut représenter l’accès à une chaîne de streaming, à un jeu, à un objet ou une capacité unique. Pour en savoir plus sur la configuration et l’utilisation des produits par abonnement, consultez ces instructions.

Abonnement

Combinaison de produit et de plan choisi. L’abonnement est créé lorsque l’utilisateur choisit un plan d’abonnement spécifique et obtient l’accès à un service. Le nombre d’abonnements qu’un utilisateur peut souscrire simultanément dépend du nombre de produits inclus dans le projet. Les conditions de l’abonnement (période de facturation, coût, etc.) sont déterminées par les spécifications du plan choisi. Si les conditions du plan sont modifiées après la création de l’abonnement, les conditions de l’abonnement existant demeurent inchangées.

EXEMPLE 1

Produit : accès au jeu

  • Plan d'abonnementSilver : 10 $ par mois
  • Plan d'abonnementGold : 100 $ par an

Un utilisateur peut sélectionner l’un des abonnements suivants :

  • Abonnement 1 : accès au jeu avec le plan de 10 $/mois
  • Abonnement 2 : accès au jeu avec le plan de 100 $/an

EXEMPLE 2

Produit 1 : accès au jeu1

Produit 2 : accès au jeu2

  • Plan d'abonnement : 10 $ par mois

Un utilisateur peut souscrire deux abonnements simultanément :

  • Abonnement 1 : accès au jeu1 avec le plan de 10 $/mois
  • Abonnement 2 : accès au jeu2 avec le plan de 10 $/mois
Note
Si aucun produit par abonnement n’est configuré, l’utilisateur ne peut souscrire qu’un seul abonnement à la fois. Pour la possibilité de souscrire plusieurs abonnements simultanément, vous devez configurer des produits.
Groupe de plans

Ensemble de plans ayant la même valeur de paramètre group_id. Pour créer ou modifier un groupe, passez le paramètre group_id aux appels API :

La création d’un groupe de plans est nécessaire si vous souhaitez :

  • créer un produit par abonnement ;

  • limiter le nombre de plans que l’utilisateur peut choisir pour souscrire à un produit ;

  • permettre à l’utilisateur de passer à un autre plan au sein du groupe.

Pour en savoir plus sur la configuration et l’utilisation des groupes, consultez ces instructions.

Période d'essai
Période pendant laquelle l’utilisateur peut essayer l’abonnement sans le payer. Fonctionnalités :
  • Lorsqu’un abonnement avec une période d’essai est acheté, un compte de facturation est créé et une autorisation de paiement est effectuée. Un petit montant est prélevé sur le compte de l’utilisateur, puis remboursé. Aucun webhook de paiement n’est envoyé à l’URL du webhook lors du débit initial ;
  • À la fin de la période d’essai, le coût total du plan d’abonnement est facturé, et les webhooks Paiement et Abonnement mis à jour sont envoyés à l’URL du webhook. Si le paiement de l’abonnement échoue, le webhook Abonnement annulé est envoyé. La période d’essai n’est pas incluse dans la période de validité du plan et sa durée est calculée séparément ;
  • Une période d’essai peut être ajoutée en tant que bonus à une promotion.
Période de grâce
Période de paiement différé. Pendant cette période, l’utilisateur qui n’a pas payé son abonnement à temps continue à utiliser les services. Fonctionnalités :
  • La période de grâce n’est disponible que pour les abonnements de type plan régulier et paiement unique. Les paiements pour les abonnements avec renouvellement automatique sont effectués automatiquement ;
  • Xsolla informe l’utilisateur de la nécessité de procéder au paiement au moment où la période de grâce s’active, ainsi que chaque jour subséquent de la période de grâce ;
  • Si l’utilisateur paie son abonnement pendant la période de grâce, le paiement est effectué pour l’intégralité de la période de paiement ;
  • Le nombre de jours pendant lesquels l’utilisateur a accédé au service du partenaire sans paiement effectif est déduit du nombre total de jours de la période d’abonnement ;
  • Si la valeur du champ Grace period dans les paramètres du plan est 0, le plan ne dispose pas de période de grâce.
Pour en savoir plus sur la configuration et l’utilisation de la période de grâce, consultez ces instructions.
Période de nouvelles tentatives
Période pendant laquelle des tentatives de débit à partir du compte de paiement enregistré sont effectuées. Pendant cette période, l’utilisateur continue à utiliser les services d’abonnement. Elle s’active après un échec de débit. Fonctionnalités :
  • La période de relance n’est disponible que pour les abonnements de type plan régulier et paiement automatique ;
  • Les tentatives de débit sont effectuées à partir du compte de paiement enregistré une fois par jour ;
  • Le système continuera d’essayer de débiter le compte jusqu’à ce que l’abonnement soit renouvelé, annulé par l’utilisateur ou résilié une fois le nombre de nouvelles tentatives de facturation dépassé ;
  • Si l’utilisateur renouvelle son abonnement avant la fin de la période de relance, le nombre de jours pendant lesquels l’utilisateur a accédé au service du partenaire sans paiement effectif est déduit du nombre total de jours de la période d’abonnement ;
  • Si la valeur du champ Number of billing retries dans les paramètres du plan est 0, le plan ne dispose pas de période de relance.
Pour en savoir plus sur la configuration et l’utilisation de la période de relance, consultez ces instructions.
Paiement automatique
Type de renouvellement d’abonnement qui débite automatiquement votre compte de facturation enregistré. Aucune action de la part de l’utilisateur n’est requise. Cependant, si le compte de facturation n’a pas été enregistré, un abonnement avec ce type de renouvellement passe au statut Non renewing.
Paiement unique
Type de renouvellement d’abonnement où l’utilisateur procède au paiement en suivant un lien de paiement reçu par e-mail. Utilisé lorsque l’utilisateur choisit un mode de paiement qui ne prend pas en charge les paiements automatiques.

Statuts des abonnements

Un abonnement peut avoir l’un des statuts suivants :

  • Active. Statut principal. L’abonnement est créé et devient actif après le premier paiement réussi. Les débits subséquents ne sont effectués que pour les abonnements actifs.

Avis
Vous ne pouvez pas créer un abonnement manuellement via API. Cela ne se fait qu’automatiquement au moment de l’achat.
  • Canceled. L'abonnement a été annulé avec effet immédiat pour l'une des raisons suivantes :
    • Modification du statut via une méthode API ou depuis le Compte éditeur Xsolla ;
    • Annulation par l'utilisateur ;
    • Expiration de l'abonnement, si une date d'expiration a été définie dans les paramètres ;
    • Dépassement du nombre maximum de tentatives de facturation. Par défaut, trois tentatives sont autorisées. Pour modifier ce nombre, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com ;
    • L'utilisateur est introuvable dans le jeu ;
    • Suppression du compte de l'utilisateur.
Note
Lorsqu’un abonnement est annulé, le dernier paiement peut être remboursé. Cette option est disponible à la fois pour le partenaire et pour l’utilisateur.
  • Non renewing. Renouvellement d'abonnement annulé. L'abonnement durera jusqu'à la fin du cycle de facturation en cours avant que le statut ne passe à Canceled. Le renouvellement peut être annulé pour l'une des raisons suivantes :
    • Modification du statut via une méthode API ou depuis le Compte éditeur ;
    • Annulation par l'utilisateur via un lien e-mail ;
    • Suppression du compte de l'utilisateur.
Votre progression
Merci pour votre commentaire !
Dernière mise à jour: 31 Juillet 2024

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !