Gestion des abonnements des utilisateurs

Pour implémenter la gestion d’abonnements dans votre application, procédez comme suit :

1. Récupérez la liste des abonnements de l’utilisateu et affichez-les dans l’application.
2. Implémentez la gestion des abonnements — ouvrez le compte de l’abonné ou gérez des abonnements spécifiques directement depuis votre application.

Pour une implémentation simplifiée, consultez l’exemple.

Récupérez les abonnements de l’utilisateur

Pour récupérer tous les abonnements actifs de l’utilisateur actuel, utilisez la méthode XsollaSubscriptions.GetSubscriptions. Cette méthode renverra les abonnements dont les statuts sont active, non_renewing et freezeassociés au compte de l’utilisateur actuel.

Vous pouvez également obtenir des informations détaillées sur chaque abonnement à l’aide de la méthode XsollaSubscriptions.GetSubscriptionDetails.

Utilisez les données renvoyées (l’objet SubscriptionItem) pour afficher l’interface utilisateur de gestion des abonnements dans votre application.

Champs clés pour la configuration des widgets de l’interface utilisateur :

• plan_name — nom de l’abonnement.
• status — statut actuel de l’abonnement (new, active, canceled, non_renewing, freeze).
• date_next_charge — date et heure du prochain prélèvement automatique.
• charge — informations relatives au paiement récurrent. L’objet contient le prix (amount) et la devise (currency).

Gestion des abonnements

Ouvrez un compte d’abonné

Xsolla propose une interface utilisateur prête à l’emploi (le compte d’abonné) permettant aux utilisateurs de consulter et gérer leurs abonnements. Il s’agit de la méthode la plus simple et la plus recommandée pour implémenter la gestion des abonnements.

Fonctionnalités principales :

• consultation des informations de l’abonnement
• gestion des abonnements — résiliation immédiate, désactivation du renouvellement automatique ou réactivation (selon les paramètres du projet)
• changement de plan d’abonnement
• modification du mode de paiement

Pour afficher le compte d’abonné à l’utilisateur, appelez la méthode XsollaSubscriptions.GetUserAccountUrl. Si la requête aboutit, un objet UserAccountLink contenant un lien vers l’interface utilisateur du compte sera transmis à la fonction de rappel. Pour ouvrir le lien dans un navigateur externe ou dans une WebView intégrée, utilisez la méthode XsollaWebBrowser.Open.

Gestion spécifique des abonnements

Pour ouvrir l’interface utilisateur de gestion d’un abonnement spécifique depuis votre application, utilisez la méthode XsollaSubscriptions.GetSubscriptionManagementUrl. Si la requête aboutit, un objet PaymentLink contenant un lien vers l’interface utilisateur de gestion de l’abonnement sera transmis à la fonction de rappel. Pour ouvrir le lien dans un navigateur externe ou dans une WebView intégrée, utilisez la méthode XsollaWebBrowser.Open.

Résiliation de l’abonnement

Pour résilier un abonnement depuis l’interface utilisateur de votre application, utilisez la méthode XsollaSubscriptions.CancelSubscription. Cette méthode désactive le renouvellement automatique et l’abonnement passe au statut non_renewing. Cela signifie qu’aucun prélèvement automatique n’aura lieu lors de la prochaine période de facturation ; l’abonnement reste actif jusqu’à la fin de la période payée.

Renouvellement de l’abonnement

Pour implémenter la navigation vers l’interface utilisateur de renouvellement d’abonnement depuis votre application, utilisez la méthode XsollaSubscriptions.GetSubscriptionRenewalUrl. Une fois la requête réussie, un objet PaymentLink contenant un lien vers l’interface utilisateur de renouvellement d’abonnement sera transmis à la fonction de rappel. Pour ouvrir le lien dans un navigateur externe ou dans une WebView intégrée, utilisez la méthode XsollaWebBrowser.Open.