REST Resource: purchases.voidedpurchases

Risorsa: VoidedPurchase

Una risorsa VoidedPurchase indica un acquisto annullato, rimborsato o stornato.

Rappresentazione JSON 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
Campi
kind

string

Questo tipo rappresenta un oggetto di acquisto annullato nel servizio androidpublisher.
purchaseToken

string

Il token che identifica in modo univoco un acquisto singolo o un abbonamento. Per identificare in modo univoco i rinnovi degli abbonamenti, utilizza orderId (disponibile a partire dalla versione 3 dell'API).
purchaseTimeMillis

string (int64 format)

L'ora in cui è stato effettuato l'acquisto, in millisecondi a partire dall'epoca (1° gennaio 1970).
voidedTimeMillis

string (int64 format)

La data e l'ora in cui l'acquisto è stato annullato/rimborsato/stornato, in millisecondi a partire dal 1° gennaio 1970.
orderId

string

L'ID ordine che identifica in modo univoco un acquisto singolo, un acquisto in abbonamento o un rinnovo dell'abbonamento.
voidedSource

integer

L'iniziatore dell'acquisto annullato, i valori possibili sono: 0. Utente 1. Sviluppatore 2. Google
voidedReason

integer

Il motivo per cui l'acquisto è stato annullato. I valori possibili sono: 0. Altro 1. Remorse 2. Not_received 3. Difettoso 4. Accidental_purchase 5. Attività fraudolenta 6. Acquisto accidentale 7. Storno di addebito 8. Unacknowledged_purchase
voidedQuantity

integer

La quantità annullata a seguito di un rimborso parziale basato sulla quantità. Gli acquisti annullati di rimborsi parziali basati sulla quantità possono essere restituiti solo quando includeQuantityBasedPartialRefund è impostato su true.

Metodi

list

 Elenca gli acquisti annullati, rimborsati o stornati.

Codici di errore

Le operazioni di questa risorsa restituiscono i seguenti codici di errore HTTP:

Codice di errore Motivo Descrizione Risoluzione
400 invalidValue Nella richiesta è stato fornito un valore non valido. Questo errore viene spesso restituito per un token di acquisto non valido o con un formato non corretto. Correggi il valore del campo non valido nel corpo della richiesta o nei parametri in base al riferimento API.
400 required Nella richiesta manca un campo o un parametro obbligatorio. Consulta la documentazione dell'API per assicurarti di includere tutti i campi e i parametri obbligatori.
403 userInsufficientPermission L'utente non dispone di autorizzazioni sufficienti per eseguire l'operazione richiesta. Assicurati che l'utente autenticato disponga delle autorizzazioni necessarie in Google Play Console. Per ulteriori dettagli, consulta Utilizzo di un service account.
404 notFound Impossibile trovare la risorsa richiesta. Verifica che gli identificatori (ad es. token di acquisto, nome del pacchetto, ID prodotto, ID abbonamento) siano corretti.
409 concurrentUpdate È stato effettuato un tentativo di aggiornamento di un oggetto in fase di aggiornamento simultaneo. Riprova a inviare la richiesta con il backoff esponenziale. Evita modifiche simultanee alla stessa risorsa.
5xx Generic error Errore generico nel server Google Play. Riprova a inviare la richiesta.

Se il problema persiste, contatta il tuo Account Manager Google Play o invia una richiesta di assistenza. Ti consigliamo di controllare la dashboard dello stato di Play per eventuali interruzioni note.