Comment permettre à l’utilisateur de changer de plan d’abonnement

Comment ça marche

• Lors du choix d’un nouveau plan, un remboursement est effectué sur le solde de l’utilisateur pour la période non utilisée de l’abonnement en cours.
• Le paiement du nouveau plan d’abonnement est entièrement effectué à partir du solde de l’utilisateur. Si son solde est insuffisant, un paiement supplémentaire est effectué par l’un des modes de paiement autorisés dans le projet.
• Lors du changement de plan, les fonds sont débités immédiatement après la confirmation du paiement, même si le projet est configuré pour que le changement de plan prenne effet à partir de la prochaine période de facturation.

• Si la devise du nouveau plan est différente de celle du plan actuel, l’achat du nouveau plan sera effectué avec une conversion de devise.

• l’utilisateur a déjà un abonnement actif au plan vers lequel le plan actuel est en train de passer ;
• l’abonnement que l’utilisateur souhaite changer n’a pas le statut Active ;
• le plan d’abonnement que l’utilisateur souhaite changer est de type Plan à vie : un tel abonnement ne peut être annulé que pendant la période de remboursement spécifiée.

Comment configurer

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans la barre latérale, cliquez sur Subscriptions et accédez à la section Settings.
3. Dans la section Changing plan, réglez la bascule Ability to choose a different plan sur On.
4. Les changements de plan sont autorisés par défaut à partir de la période suivante. Pour permettre le changement de plan au cours de la période en courante, sélectionnez Now. Quand cette option est sélectionnée, le plan change immédiatement après la confirmation du paiement.
5. Pour permettre les changements de plan plus d’une fois par jour, réglez la bascule Ability to choose a different plan several times on the same day sur On.
6. Lorsque vous ouvrez l’interface de paiement, utilisez :
   • l’appel API côté serveur Créer un jeton ;
   • si vous utilisez Xsolla Login dans votre projet, l’appel API côté client pour obtenir un lien permettant d’ouvrir l’interface de paiement .

Ouverture de l'interface de paiement via l'appel API côté serveur Créer un jeton

1. Obtenez un jeton pour ouvrir l’interface de paiement. Pour ce faire, passez ce qui suit à la méthode :
   • valeur change_plan dans le paramètre purchase.subscription.operation ;
   • ID du nouveau plan dans le paramètre purchase.subscription.plan_id ;
   • ID de produit par abonnement dans le paramètre purchase.subscription.product_id, si vous utilisez des produits par abonnement. Pour l’obtenir, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com.
2. Ouvrez l’interface de paiement en utilisant l’une des options suivantes :
   • Script Pay Station Embed ;
   • Iframe ;
   • Nouvelle fenêtre.

Ouverture de l'interface de paiement sur la page de gestion des abonnements à l'aide de l'appel API côté client

Si Xsolla Login est configuré dans votre projet, utilisez l’appel API côté client pour obtenir un lien permettant d’ouvrir l’interface de paiement. Le lien renvoyé dans la réponse vous permet d’ouvrir l’interface de paiement sur la page de gestion des abonnements, où les utilisateurs peuvent sélectionner un abonnement actif et le changer.

Pour ce faire, côté client de votre application, implémentez la réception de lien vers l’interface de paiement à l’aide de la requête HTTP POST : https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/manage. 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.

Passez des paramètres supplémentaires pour la customisation si nécessaire.

Paramètres du corps de la requête :

curl -X 'POST' \
'https://subscriptions.xsolla.com/api/user/v1/projects/{project_id}/subscriptions/manage?country=RU  ' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer client_user_jwt'
{
  "settings": {
    "ui": {
      "size": "large",
      "theme": "string",
      "version": "desktop",
      "desktop": {
        "header": {
          "is_visible": true,
          "visible_logo": true,
          "visible_name": true,
          "type": "compact",
          "close_button": true
        }
      },
      "mobile": {
        "mode": "saved_accounts",
        "footer": {
          "is_visible": true
        },
        "header": {
          "close_button": true
        }
      },
      "license_url": "string",
      "mode": "user_account",
      "user_account": {
        "history": {
          "enable": true,
          "order": 1
        },
        "payment_accounts": {
          "enable": true,
          "order": 1
        },
        "info": {
          "enable": true,
          "order": 1
        },
        "subscriptions": {
          "enable": true,
          "order": 1
        }
      }
    },
    "currency": "str",
    "locale": "st",
    "external_id": "string",
    "payment_method": 1,
    "return_url": "string",
    "redirect_policy": {
      "redirect_conditions": "none",
      "delay": 0,
      "status_for_manual_redirection": "none",
      "redirect_button_caption": "string"
    }
  }
}

Exemple de réponse :

{
  "link_to_ps": "https://secure.xsolla.com/paystation2/?access_token=<access_token>"
}