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.

Hinweis

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/&amp;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:

ParameterTypBeschreibung
projectId
integerErforderlich. Projekt-ID. Diesen Parameter finden Sie im Kundenportal neben dem Projektnamen.
subscriptionId
integerErforderlich. Abonnement-ID.
Im Anfragerumpf übermitteln:
ParameterTypBeschreibung
amount
floatErforderlich. Abzubuchender Betrag.
currency
stringErforderlich. Währungscode bestehend aus drei Buchstaben gemäß ISO 4217.
Anfragebeispiel:
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"
}

Antwortbeispiele:

  • 200 — Abzubuchender Betrag erfolgreich geändert
  • 400 — Abonnement nicht aktiv
  • 404 — Abonnement nicht gefunden
War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Letztmalig aktualisiert: 31. Juli 2024

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!