Commencer
Flux d'intégration
Pour intégrer Subscriptions :
- Créez un projet pour votre jeu.
- Configurez des plans d’abonnement.
- Configurez l’autorisation.
- Créez une interface de catalogue.
- Configurez l’ouverture de l’interface de paiement.
- Implémentez l’obtention des informations d’abonnement.
- 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
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'abonnement
Silver : 10 $ par mois - Plan d'abonnement
Gold : 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
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
- 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
- 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.
Période de nouvelles tentatives
- 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.
Paiement automatique
Paiement unique
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.
- 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.
- 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.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.