Achat d’abonnement
Pour mettre en place l’achat d’abonnements dans votre application, procédez comme suit :
- Récupérez la liste des plans d’abonnement disponibles à l’achat et affichez-les à l’utilisateur.
- Initiez l’achat du plan sélectionné par l’utilisateur.
Pour une implémentation simplifiée, consultez l’exemple.
L’achat et la gestion des abonnements sont réservés aux utilisateurs authentifiés. Pour plus d’informations sur l’utilisation du SDK pour l’authentification des utilisateurs, consultez la section Authentication.
Les exemples de code utilisent l’authentification par nom d’utilisateur et un mot de passe (la méthode XsollaAuth.SignIn) avec des identifiants codés en dur afin de simplifier la démonstration du processus d’abonnement. Dans une application réelle, vous devez implémenter une logique d’authentification complète et la validation de la session en cours à l’aide de la méthode XsollaAuth.AuthBySavedToken.
Récupérez la liste des plans d’abonnement
Pour récupérer la liste des plans configurés dans le Compte éditeur, appelez la méthode XsollaSubscriptions.GetSubscriptionPublicPlans ou XsollaSubscriptions.GetSubscriptionPlans. Utilisez les données renvoyées (l’objet PlanItem) pour afficher le catalogue d’abonnements dans votre application.
Champs clés pour la configuration des widgets de l’interface utilisateur :
plan_name— nom de l’abonnement.plan_description— description des avantages du plan.charge— objet contenant le prix (amount) et la devise (currency).period— période de facturation.
Initiez l’achat d’un abonnement
Pour initier l’achat d’un plan d’abonnement sélectionné par l’utilisateur, appelez la méthode XsollaSubscriptions.GetSubscriptionPurchaseUrl en lui transmettant le paramètre planExternalId. Si la requête aboutit, un objet PaymentLink contenant un lien vers l’interface utilisateur de gestion des abonnements 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.
Pour suivre l’état d’une commande, vous devez configurer le traitement des webhooks et recevoir les informations relatives à la commande côté serveur de votre application. Cela vous permettra d’implémenter une validation supplémentaire des achats finalisés.
Consultez la section Obtenir des informations d’abonnement pour obtenir des informations détaillées sur la configuration et le test des webhooks.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.
