REST Resource: purchases.voidedpurchases

Ressource: VoidedPurchase

Eine VoidedPurchase-Ressource gibt einen Kauf an, der entweder storniert, erstattet oder zurückgebucht wurde.

JSON-Darstellung 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
Felder
kind

string

Dieser Typ stellt ein ungültiges Kaufobjekt im androidpublisher-Dienst dar.
purchaseToken

string

Das Token, das einen Einmalkauf oder ein Abo eindeutig identifiziert. Verwenden Sie orderId (ab Version 3 der API verfügbar), um Abonnements, die verlängert werden, eindeutig zu identifizieren.
purchaseTimeMillis

string (int64 format)

Der Zeitpunkt, zu dem der Kauf getätigt wurde, in Millisekunden seit der Epoche (1. Januar 1970).
voidedTimeMillis

string (int64 format)

Der Zeitpunkt, zu dem der Kauf storniert, erstattet oder zurückgebucht wurde, in Millisekunden seit der Epoche (1. Januar 1970).
orderId

string

Die Bestell-ID, die einen Einmalkauf, einen Abo-Kauf oder eine Abo-Verlängerung eindeutig identifiziert.
voidedSource

integer

Der Initiator des stornierten Kaufs. Mögliche Werte: 0. Nutzer 1 Entwickler 2 Google
voidedReason

integer

Der Grund, warum der Kauf storniert wurde. Mögliche Werte: 0. Sonstiges 1 Kaufreue 2: Not_received 3. Defekt 4 Accidental_purchase 5. Betrug 6. Friendly_fraud 7. Rückbuchung 8 Unacknowledged_purchase
voidedQuantity

integer

Die stornierte Menge als Ergebnis einer mengenbasierten Teilerstattung. Stornierte Käufe mit mengenbasierten Teilerstattungen können nur zurückgegeben werden, wenn „includeQuantityBasedPartialRefund“ auf „true“ gesetzt ist.

Methoden

list

 Hier werden die Käufe aufgeführt, die storniert, erstattet oder zurückgebucht wurden.

Fehlercodes

Die Vorgänge dieser Ressource geben die folgenden HTTP-Fehlercodes zurück:

Fehlercode Grund Beschreibung Auflösung
400 invalidValue In der Anfrage wurde ein ungültiger Wert angegeben. Dieser Fehler wird häufig zurückgegeben, wenn das Kauf-Token fehlerhaft oder ungültig ist. Korrigieren Sie den ungültigen Feldwert im Anfragetext oder in den Parametern anhand der API-Referenz.
400 required In der Anfrage fehlt ein erforderliches Feld oder ein erforderlicher Parameter. In der API-Dokumentation finden Sie Informationen dazu, ob alle Pflichtfelder und ‑parameter enthalten sind.
403 userInsufficientPermission Der Nutzer hat nicht die erforderlichen Berechtigungen, um den angeforderten Vorgang auszuführen. Prüfen Sie, ob der authentifizierte Nutzer die erforderlichen Berechtigungen in der Google Play Console hat. Weitere Informationen finden Sie unter Dienstkonto verwenden.
404 notFound Die angeforderte Ressource wurde nicht gefunden. Prüfen Sie, ob die Kennzeichnungen (z.B. Kauf-Token, Paketname, Produkt-ID, Abo-ID) korrekt sind.
409 concurrentUpdate Es wurde versucht, ein Objekt zu aktualisieren, das gleichzeitig aktualisiert wird. Wiederholen Sie die Anfrage mit exponentiellem Backoff. Vermeiden Sie gleichzeitige Änderungen an derselben Ressource.
5xx Generic error Allgemeiner Fehler auf dem Google Play-Server. Wiederholen Sie Ihre Anfrage.

Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Google Play-Kundenbetreuer oder senden Sie eine Supportanfrage. Prüfen Sie im Play-Status-Dashboard, ob bekannte Ausfälle vorliegen.