Abos und einmalige Käufe verwalten

Im Rahmen des Tagesgeschäfts müssen Sie möglicherweise Verwaltungsaktionen für Abos oder einmalige Käufe ausführen. Beispielsweise muss Ihr Kundenservice möglicherweise vollständige oder teilweise Erstattungen für Nutzer veranlassen oder Sie müssen in bestimmten Fällen Berechtigungen widerrufen. Sie können Bestellungen über die Play Console verwalten oder, wenn Sie sie über Ihr eigenes System verwalten möchten, die Google Play Developer API verwenden.

Abos kündigen

Abokündigungen können von Nutzern oder Entwicklern initiiert werden.

Vom Nutzer initiierte Stornierungen

Nutzer können ein Google Play-Abo jederzeit im Play Store kündigen. Gegebenenfalls müssen Sie Nutzern auch die Möglichkeit geben, ihre Abos in Ihrer App und auf Ihrer Website zu kündigen.

Die einfachste Möglichkeit, Nutzern die freiwillige Kündigung zu ermöglichen, besteht darin, Deeplinks in Ihrer App zum Google Play Store bereitzustellen, wo sie ihre Abos aufrufen und verwalten können.

Vom Entwickler veranlasste Kündigungen

Als Entwickler müssen Sie Kündigungen möglicherweise auch über Ihr Backend auslösen. Mit der purchases.subscriptions.cancel API kannst du einen Abokauf kündigen. Sie können diese Methode beispielsweise verwenden, um einen Legacy-Dienst zu deaktivieren. Wenn ein Abo gekündigt wird, wird keine Erstattung gewährt und der Nutzer behält den Zugriff bis zum Ende des aktuellen Abrechnungszeitraums.

Mit dieser Methode können Sie die folgenden Arten von Stornierungen im Anfragetextparameter cancellationType angeben:

  • USER_REQUESTED_STOP_RENEWALS: Kündigt das Abo so, als ob der Nutzer es im Google Play Store gekündigt hätte. Alle Ratenzahlungen werden für den Rest der aktuellen Mindestlaufzeit fortgesetzt. Nutzer können das Abo im Google Play Store vor Ablauf wiederherstellen oder nach Ablauf wieder abonnieren, wenn dies für das Basis-Abo aktiviert ist.

  • DEVELOPER_REQUESTED_STOP_PAYMENTS: Kündigt das Abo und verhindert weitere Zahlungen. Nutzer können das Abo im Google Play Store nicht wiederherstellen oder neu abonnieren. Du kannst ihnen jedoch die Möglichkeit geben, es in deiner App noch einmal zu abonnieren.

Nutzern ermöglichen, nicht abgelaufene Abos wiederherzustellen

In manchen Fällen kann es sinnvoll sein, Nutzern die Möglichkeit zu geben, nicht abgelaufene Abos im Abocenter von Google Play wiederherzustellen, nachdem Sie die Kündigung als Entwickler veranlasst haben. Sie können beispielsweise einen benutzerdefinierten Kündigungsablauf in der App anbieten. Anhand Ihrer Geschäftslogik können Sie entscheiden, welche Kündigungen, die von Ihrem Backend ausgelöst wurden, von Nutzern wiederhergestellt werden können.

Wenn Sie angeben möchten, dass ein Nutzer die Kündigung rückgängig machen kann, senden Sie eine POST-Anfrage an die purchases.subscriptions.cancel API und legen Sie den Anfrageparameter cancellationType auf den Wert USER_REQUESTED_STOP_RENEWALS fest.

Beispiel:

  • Kauftoken des Abos 1a2b3c4d5e6f7g8h9i0j
  • Paketname der App: com.your.app
  • Abo-ID: your-subscription-product

HTTP-POST-Anfrage:

https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptions/your-subscription-product/tokens/1a2b3c4d5e6f7g8h9i0j:cancel

Anfragetext:

{
  "cancellationType": "USER_REQUESTED_STOP_RENEWALS"
}

Nutzern ermöglichen, abgelaufene Abos erneut zu abonnieren

Wenn Sie das erneute Abonnieren eines abgelaufenen Abos zulassen möchten, müssen Sie im Basis-Abo des Abos die Option Erneut abonnieren aktivieren und dann das Abo kündigen, indem Sie den Parameter cancellationType auf den Wert USER_REQUESTED_STOP_RENEWALS setzen.

Nutzern erlauben, nur in Ihrer Anwendung ein neues Abo abzuschließen

Wenn Sie den Parameter cancellationType auf DEVELOPER_REQUESTED_STOP_PAYMENTS festgelegt oder den Parameter cancellationType nicht festgelegt haben, können Nutzer ihr Abo nicht über das Abocenter von Google Play wiederherstellen. Nutzer können das Abo jedoch bei Bedarf über Ihre App wieder abschließen.

Diese Aktion löst eine SUBSCRIPTION_CANCELED-Entwicklerbenachrichtigung in Echtzeit aus. Behandle diese Kündigungen wie unter Kündigungen beschrieben.

Abrechnung verschieben

Sie können den Berechtigungszeitraum für ein Abo mit der Methode subscriptionsv2.defer verlängern. Wenn Sie ein Abo mit Add-ons verschieben, werden alle Elemente im Abo um denselben Zeitraum verschoben. Während des Aufschubzeitraums bleibt der Nutzer Abonnent Ihrer Inhalte, ihm wird jedoch für die zusätzliche Zeit nichts in Rechnung gestellt. Wenn Sie die Abrechnung für ein Abo verschieben, werden die Statusinformationen entsprechend aktualisiert. Dies wird im Feld expiryTime in den Statusinformationen zum Kauf angezeigt:

  • Bei aktiven wiederkehrenden Abos wird durch die verzögerte Abrechnung das nächste Verlängerungsdatum verschoben.
  • Bei Prepaid-Tarifen wird durch die verzögerte Abrechnung die Ablaufzeit verlängert.

Hier einige Beispiele für die Verwendung der verzögerten Abrechnung:

  • Biete Nutzern als Sonderangebot kostenlosen Zugriff an, z. B. eine Woche kostenlos für bestehende Abonnenten, die eine Feedback-Umfrage ausfüllen.
  • Kunden im Rahmen des Kundenservice kostenlosen Zugriff gewähren, z. B. nach einem längeren Ausfall, der die Nutzung Ihres Dienstes beeinträchtigt haben könnte.

Die Abrechnung kann pro API-Aufruf um einen Tag bis zu einem Jahr verschoben werden. Wenn Sie das Ende der Berechtigung noch weiter verschieben möchten, rufen Sie die API noch einmal auf, bevor das neue Ablaufdatum erreicht ist.

Diese Aktion löst eine SUBSCRIPTION_DEFERRED-Entwicklerbenachrichtigung in Echtzeit aus. Informationen zum Umgang mit diesen Ereignissen finden Sie unter Abrechnung für einen Abonnenten aufschieben im Artikel Abos.

Beispiel:

  1. Der Streamingdienst FitnessGoals möchte im Februar eine Werbeaktion starten, um regelmäßiges Training zu fördern.

  2. Sie beschließen, allen Abonnenten, die im Februar mindestens zehnmal mit FitnessGoals trainieren, einen zusätzlichen Monat Service anzubieten.

  3. Sie verfolgen die Ergebnisse der Challenge und rufen am 1. März die Methode subscriptionsv2.defer für jeden aktiven Abo-Kauf von Nutzern auf, die die Challenge im Februar abgeschlossen haben.

  4. Diese Nutzer erhalten einen zusätzlichen Monat lang kostenlose Trainingsvideos und erzählen allen ihren Freunden, wie FitnessGoals ihnen hilft, gesund zu bleiben.

Erstattungen und Widerrufe veranlassen

Es gibt viele Situationen, in denen Sie eine Erstattung für ein Abo oder einen einmaligen Kauf veranlassen oder den Zugriff darauf widerrufen möchten.

Bestellung anhand der Bestell-ID vollständig erstatten

Mit der orders.refund API kannst du innerhalb von drei Jahren nach dem Kauf volle Erstattungen für jede Bestellung veranlassen. Die Methode orders.refund erhält einen Parameter „revoke“, der angibt, ob der Zugriff zusätzlich zur Erstattung widerrufen werden soll.

Wenn du einen Widerruf mit dem Erstattungsaufruf für einen Abokauf ausstellst, wird das Abo sofort beendet. Dadurch werden sowohl eine SUBSCRIPTION_REVOKED-Entwicklerbenachrichtigung in Echtzeit als auch ein VoidedPurchaseNotification ausgelöst (aufgezeichnet in der Voided Purchases API). Informationen zum Umgang mit diesen Ereignissen findest du im Leitfaden zur Verwaltung des Abolebenszyklus im Abschnitt „Widerrufe“.

Beispiel:

  1. Zur Feier des Beginns der neuen Weltmeisterschaft beschließt die E-Sport-App Football-Not-Soccer, kostenlose virtuelle Trikots an alle Nutzer zu verlosen, die in den ersten 24 Stunden neue Mannschaftstrikots kaufen.

  2. Football-Not-Soccer verwendet die orders.refund API ohne einen Parameter für den Widerruf, um den Gewinnern die Kosten für die Trikots zu erstatten.

Abo per Kaufftoken widerrufen und erstatten

In bestimmten Fällen müssen Sie möglicherweise den Zugriff auf das Abo eines Nutzers widerrufen und eine Erstattung veranlassen. Google Play Billing bietet über die subscriptionsv2.revoke API Widerrufsmethoden, einschließlich vollständiger und anteiliger Erstattungen. Mit diesem Endpunkt können Sie revocationContext angeben, um festzulegen, wie die Erstattung berechnet wird.

Diese Aktion löst sowohl eine SUBSCRIPTION_REVOKED-Echtzeitbenachrichtigung für Entwickler als auch eine VoidedPurchaseNotification-Benachrichtigung aus und wird in der Voided Purchases API aufgezeichnet. Ihre App sollte diese Kündigungen wie unter Widerrufe beschrieben verarbeiten.

Beispiel:

  • Kauf mit dem Kauf-Token 1a2b3c4d5e6f7g8h9i0j
  • Anwendung mit dem Paketnamen com.your.app
  • Absicht, eine anteilige Erstattung zu veranlassen

HTTP-POST-Anfrage:

https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptionsv2/tokens/1a2b3c4d5e6f7g8h9i0j:revoke

Anfragetext:

{
  "revocationContext": {
    "proratedRefund": {}
  }
}

Volle Erstattung

Wenn Sie ein Abo kündigen und den vollen Betrag des aktuellen Abrechnungszeitraums erstatten möchten, veranlassen Sie eine volle Erstattung. Verwenden Sie die Funktion purchases.subscriptionsv2.revoke und legen Sie "fullRefund": {} als Erstattungstyp fest.

Beispiel:

  1. Maria hat ein sich automatisch verlängerndes 30-tägiges Abo für den monatlichen Streamingdienst SuperMovies. Maria hat technische Probleme, die sie daran hindern, auf die Inhalte zuzugreifen. Am dritten Tag ihres Abrechnungszeitraums kontaktiert sie den Kundenservice und gibt an, dass sie nie Zugriff auf das Abo erhalten hat.

  2. Der Kundenservice sucht in seinem System nach den Details zum Kauf des Abos von Maria und löst einen Aufruf an purchases.subscriptionsv2.revoke aus, um eine volle Erstattung zu beantragen.

  3. Der Kundenservice teilt Maria mit, dass sie 100 % des Abopreises erstattet bekommt und das Abo nicht mehr aktiv ist.

Anteilige Erstattungen

Wenn Sie ein Abo kündigen und die verbleibende Berechtigungszeit teilweise erstatten möchten, veranlassen Sie eine anteilige Erstattung. Verwenden Sie die Funktion purchases.subscriptionsv2.revoke und legen Sie "proratedRefund": {} als Erstattungstyp fest.

Anteilige Erstattungen werden sowohl für Abos mit automatischer Verlängerung als auch für Prepaid-Tarife mit einer Laufzeit von mindestens einer Woche unterstützt.

Beispiel:

  1. Maria hat ein sich automatisch verlängerndes 30-tägiges Abo für den monatlichen Streamingdienst SuperMovies. Sie nutzt den Dienst schon seit einiger Zeit und ist sehr zufrieden damit. Maria kontaktiert den Kundenservice am 15. Tag ihres Abrechnungszeitraums und gibt an, dass sie ins Ausland zieht und den Dienst ab dem nächsten Tag nicht mehr nutzen kann.

  2. Der Kundenservice sucht in seinem System nach den Details zu Marias Abo-Kauf und löst einen Aufruf an purchases.subscriptionsv2.revoke aus, um eine anteilige Erstattung zu beantragen.

  3. Der Kundenservice teilt Maria mit, dass sie etwa 50 % des Abopreises erstattet bekommt und der Zugriff auf den Dienst sofort beendet wird.