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_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/&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ètre | Type | Description |
---|---|---|
projectId | integer | Obligatoire. ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet. |
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
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.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.