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.

Note

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_id s’affiche :
    • Dans la section Project settings > Webhooks ;
    • 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/&amp;lt;merchant ID>/<Publisher Account section>.
  • 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.

Passez en tant que paramètres de chemin :

ParamètreTypeDescription
projectId
integerObligatoire. ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.
subscriptionId
integerObligatoire. ID d’abonnement.
Passez dans le corps de la requête :
ParamètreTypeDescription
amount
floatObligatoire. Valeur du montant à facturer.
currency
stringObligatoire. Code de devise à trois lettres selon la norme ISO 4217.
Exemple de requête :
Copy
Full screen
Small screen
curl -X PATCH \
'https://subscriptions.xsolla.com/api/v1/projects/{project_id}/subscriptions/{subscription_id}/price' \
  -H 'accept: application/json' \
  -H 'Authorization: Basic'

{
  "amount": 4.99,
  "currency": "USD"
}

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.
Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Dernière mise à jour: 31 Juillet 2024

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !