Compte abonné

Comment ça marche

Le compte abonné est un service qui permet aux utilisateurs de consulter et de gérer leurs abonnements configurés dans votre projet Xsolla.

• consultation des informations de l’abonnement
• gestion de l’abonnement — annulation immédiate, désactivation du renouvellement automatique ou réactivation (selon les paramètres du projet)
• changement de plan d’abonnement
• mise à jour du moyen de paiement

• en cliquant sur le lien dans les notifications par e-mail liées aux abonnements Xsolla
• depuis la page de paiement intégrée au jeu

• en utilisant un appel API côté serveur
• en utilisant un appel API côté client

Récupération du lien vers le compte d'un abonné via API

Appel côté serveur

Cet appel permet de générer, côté serveur de vos applications, un lien vers le compte de l’abonné via une requête HTTP POST.

Adresse URL :

https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account

Autorisation :

L’appel utilise une authentification d’accès de base. Toutes les requêtes adressées à l’API doivent contenir l’en-tête Authorization: Basic <your_authorization_basic_key>, où <your_authorization_basic_key> est la paire merchant_id:api_key encodée en Base64. Accédez au Compte éditeur pour trouver ces paramètres :

• merchant_id s’affiche :
  • Dans la section Company settings > Company ;
  • Dans l’URL de la barre d’adresse du navigateur sur n’importe quelle page du Compte éditeur. L’URL est au format suivant :https://publisher.xsolla.com/<merchant_id>.
• api_key ne s’affiche dans le Compte éditeur qu’une seule fois lors de sa création, vous devez donc la conserver de votre côté. Vous pouvez créer une nouvelle clé dans les sections suivantes :
  • Company settings > API keys ;
  • Project settings > API keys.

Paramètres :

En tant que paramètre de chemin, indiquez project_id — ID du projet, visible dans le Compte éditeur à côté du nom du projet ou dans la barre d’adresse du navigateur sur n’importe quelle page du projet. L’URL suit ce format : https://publisher.xsolla.com/<merchantId>/projects/<projectId>.

Paramètres de corps :

 1curl -v https://subscriptions.xsolla.com​/api/v1/projects/{projectId}/subscriptions/user_account \
 2-X POST \
 3-u your_merchant_id:merchant_api_key \
 4-H 'Content-Type:application/json' \
 5-H 'Accept: application/json' \
 6-d '
 7{
 8  "user_v1": "user123",
 9  "locale": "en"
10}'

Exemple de réponse :

1{
2  "redirect_url": "https://subscriptions-user-account.xsolla.com/?token=<access_token>&projectId=<project_id>&merchantId=<merchant_id>&locale=<locale>"
3}

Appel côté client

Cet appel permet de générer, côté client de vos applications, un lien vers le compte de l’abonné via une requête HTTP GET si Xsolla Login est configuré pour le projet.

Adresse URL :

https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account

Autorisation :

La requête doit contenir un en-tête Authorization: Bearer <client_user_jwt>, où <client_user_jwt> est le JSON Web Token (JWT) de l’utilisateur, un jeton unique encodé conformément à la norme Base64. Pour obtenir le jeton :

• Utilisez les appels API Register new user et Auth by username si votre application utilise l’autorisation par nom d’utilisateur et mot de passe.
• Utilisez l’appel API Auth via social network si votre application utilise l’autorisation via les réseaux sociaux.

Paramètres :

En tant que paramètre de chemin, indiquez project_id — ID du projet, visible dans le Compte éditeur à côté du nom du projet ou dans la barre d’adresse du navigateur sur n’importe quelle page du projet. L’URL suit ce format : https://publisher.xsolla.com/{merchantId}/projects/{projectId}.

Comme paramètre de requête, spécifiez locale — langue de l’interface en deux lettres minuscules selon la norme ISO 639-1. Si ce paramètre n’est pas passé, la langue est déterminée par l’adresse IP de l’utilisateur. Si la langue passée ne figure pas dans la liste Xsolla, l’anglais est utilisé par défaut.

Exemple de requête :

1curl -v https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account \
2-X GET \
3-u your_merchant_id:merchant_api_key \
4-H 'Content-Type:application/json' \
5-H 'Accept: application/json' \

Exemple de réponse :

1{
2  "redirect_url": "https://subscriptions-user-account.xsolla.com/?token=<access_token>&projectId=<project_id>&merchantId=<merchant_id>&locale=<locale>"
3}