So ändern Sie die abzubuchende Gebühr für ein aktives Abonnement
Führen Sie eine HTTP-PATCH-Anfrage (https://subscriptions.xsolla.com/api/v1/projects/{projectId}/subscriptions/{subscriptionId}/price
) aus, um den abzubuchenden Betrag eines aktiven Abonnements zu ändern.
Nach der Änderung des Betrags wird der Nutzer per E-Mail benachrichtigt. Der neue Betrag tritt zum nächsten Abrechnungszeitraum in Kraft.
Nutzen Sie die Methode Abo-Modell aktualisieren, um den abzubuchenden Betrag für neue Abonnements zu ändern. Der neue Betrag gilt nur für neue Abonnements, alle neue Abonnements werden zu den alten Bedingungen weitergeführt.
Die Anfrage muss den Header Authorization: Basic <your_authorization_basic_key>
enthalten, wobei <your_authorization_basic_key>
das gemäß dem Base64-Standard codierte merchant_id:api_key
-Paar ist.
Wechseln Sie zum Kundenportal, um folgende Parametern zu finden:
- Die
merchant_id
finden Sie:- unter Projekteinstellungen > Webhooks.
- unter Firmeneinstellungen > Firma.
- in der URL der Adressleiste des Browsers auf einer beliebigen Seite im Kundenportal. Die URL weist das folgende Format auf:
https://publisher.xsolla.com/&lt;merchant ID>/<Publisher Account section>
.
- Der
api_key
wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird. Sie sind selbst dafür verantwortlich, den Schlüssel zu speichern. Einen neuen Schlüssel können Sie in folgenden Abschnitten erstellen:- Firmeneinstellungen > API-Schlüssel
- Projekteinstellungen > API-Schlüssel
Als Pfadparameter übermitteln:
Parameter | Typ | Beschreibung |
---|---|---|
projectId | integer | Erforderlich. Projekt-ID. Diesen Parameter finden Sie im Kundenportal neben dem Projektnamen. |
subscriptionId | integer | Erforderlich. Abonnement-ID. |
Parameter | Typ | Beschreibung |
---|---|---|
amount | float | Erforderlich. Abzubuchender Betrag. |
currency | string | Erforderlich. Währungscode bestehend aus drei Buchstaben gemäß 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"
}
Antwortbeispiele:
200
— Abzubuchender Betrag erfolgreich geändert400
— Abonnement nicht aktiv404
— Abonnement nicht gefunden
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.