Comment modifier le montant facturé pour un abonnement actif
Pour modifier le montant facturé pour un abonnement actif, exécutez une requête HTTP-PATCH https://subscriptions.xsolla.com/api/v1/projects/{projectId}/subscriptions/{subscriptionId}/price.
Après la modification du montant des frais, l’utilisateur est averti par e-mail et le nouveau montant prend effet à compter de la période de facturation suivante.
Pour modifier le montant facturé pour les nouveaux abonnements, utilisez la méthode Mettre à jour un plan. Le nouveau montant s’applique uniquement aux nouveaux abonnements. Tous les abonnements existants continueront de suivre les anciennes conditions.
La requête doit contenir un en-tête Authorization: Basic <your_authorization_basic_key>, où <your_authorization_basic_key> est la paire merchant_id:api_key encodée conformément à la norme Base64.
Accédez au Compte éditeur pour trouver ces paramètres :
merchant_ids’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_keyne 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.
Allez dans votre compte pour trouver ces paramètres :
merchant_idest affiché :- Dans la section Paramètres de l’entreprise > Entreprise.
- Dans l’URL de la barre d’adresse du navigateur sur n’importe quelle page du compte. L’URL a le format suivant :
https://xsolla.com/for/free-to-play-pc/account/<merchant_id>.
api_keyest affichée dans le compte uniquement une fois lors de sa création et doit être stockée de votre côté. Vous pouvez créer une nouvelle clé dans la section suivante :- Paramètres de l’entreprise > Clés API
- Paramètres > Clés API
Allez dans votre compte pour trouver ces paramètres :
merchant_idest affiché :- Dans la section Paramètres de l’entreprise > Entreprise.
- Dans l’URL de la barre d’adresse du navigateur sur n’importe quelle page du compte. L’URL a le format suivant :
https://xsolla.com/for/premium-pc-games/account/<merchant_id>.
api_keyest affichée dans le compte uniquement une fois lors de sa création et doit être stockée de votre côté. Vous pouvez créer une nouvelle clé dans la section suivante :- Paramètres de l’entreprise > Clés API
- Paramètres > Clés API
Allez dans votre compte pour trouver ces paramètres :
merchant_idest affiché :- Dans la section Paramètres de l’entreprise > Entreprise.
- Dans l’URL de la barre d’adresse du navigateur sur n’importe quelle page du compte. L’URL a le format suivant :
https://xsolla.com/for/web-games/account/<merchant_id>.
api_keyest affichée dans le compte uniquement une fois lors de sa création et doit être stockée de votre côté. Vous pouvez créer une nouvelle clé dans la section suivante :- Paramètres de l’entreprise > Clés API
- Paramètres > Clés API
| Paramètre | Type | Description |
|---|---|---|
projectId | integer | Obligatoire. ID de projet. |
Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.
Vous pouvez trouver ce paramètre dans votre compte à côté du nom du projet.
Vous pouvez trouver ce paramètre dans votre compte à côté du nom du projet.
Vous pouvez trouver ce paramètre dans votre compte à côté du nom du projet.
| Paramètre | Type | Description |
|---|---|---|
subscriptionId | integer | Obligatoire. ID d’abonnement. |
| Paramètre | Type | Description |
|---|---|---|
amount | float | Obligatoire. Valeur du montant à facturer. |
currency | string | Obligatoire. Code de devise à trois lettres selon la norme ISO 4217. |
- curl
1curl -X PATCH \
2'https://subscriptions.xsolla.com/api/v1/projects/{project_id}/subscriptions/{subscription_id}/price' \
3 -H 'accept: application/json' \
4 -H 'Authorization: Basic'
5
6{
7 "amount": 4.99,
8 "currency": "USD"
9}
Exemples de réponses :
200— Le montant des frais a été modifié avec succès ;400— L'abonnement n'est pas actif ;404— L'abonnement est introuvable.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.
