REST Resource: purchases.voidedpurchases

Ressource : VoidedPurchase

Une ressource VoidedPurchase indique un achat qui a été annulé, remboursé ou rejeté.

Représentation JSON 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
Champs
kind

string

Ce type représente un objet d'achat annulé dans le service androidpublisher.
purchaseToken

string

Jeton qui identifie de manière unique un achat ponctuel ou un abonnement. Pour identifier de manière unique les renouvellements d'abonnement, utilisez orderId (disponible à partir de la version 3 de l'API).
purchaseTimeMillis

string (int64 format)

Heure à laquelle l'achat a été effectué, en millisecondes depuis l'epoch (1er janvier 1970).
voidedTimeMillis

string (int64 format)

Heure à laquelle l'achat a été annulé, remboursé ou fait l'objet d'une rétrofacturation, en millisecondes depuis l'epoch (1er janvier 1970).
orderId

string

ID de la commande qui identifie de manière unique un achat ponctuel, un achat d'abonnement ou un renouvellement d'abonnement.
voidedSource

integer

L'initiateur de l'achat annulé. Les valeurs possibles sont les suivantes : 0. Utilisateur 1. Développeur 2. Google
voidedReason

integer

Motif de l'annulation de l'achat. Les valeurs possibles sont les suivantes : 0. Autre 1. Remords 2. Not_received 3. Défectueux 4. Accidental_purchase 5. Fraude 6. Friendly_fraud 7. Rejet de débit 8 : Unacknowledged_purchase
voidedQuantity

integer

Quantité annulée à la suite d'un remboursement partiel basé sur la quantité. Les achats annulés de remboursements partiels basés sur la quantité ne peuvent être retournés que lorsque includeQuantityBasedPartialRefund est défini sur "true".

Méthodes

list

 Liste les achats qui ont été annulés, remboursés ou rejetés.

Codes d'erreur

Les opérations de cette ressource renvoient les codes d'erreur HTTP suivants :

Code d'erreur Motif Description Solution
400 invalidValue Une valeur incorrecte a été fournie dans la demande. Cette erreur est souvent renvoyée pour un jeton d'achat mal formé ou non valide. Corrigez la valeur de champ non valide dans le corps ou les paramètres de la requête en vous basant sur la documentation de référence de l'API.
400 required Un champ ou un paramètre obligatoire est manquant dans la requête. Consultez la documentation de l'API pour vous assurer d'inclure tous les champs et paramètres obligatoires.
403 userInsufficientPermission L'utilisateur ne dispose pas des autorisations nécessaires pour effectuer l'opération demandée. Assurez-vous que l'utilisateur authentifié dispose des autorisations nécessaires dans la Google Play Console. Pour en savoir plus, consultez Utiliser un compte de service.
404 notFound La ressource demandée est introuvable. Vérifiez que les identifiants (par exemple, le jeton d'achat, le nom du package, l'ID du produit ou l'ID de l'abonnement) sont corrects.
409 concurrentUpdate Une tentative de mise à jour d'un objet en cours de mise à jour simultanée a été effectuée. Réessayez la requête avec un intervalle exponentiel entre les tentatives. Évitez de modifier simultanément la même ressource.
5xx Generic error Erreur générique sur le serveur Google Play. Réessayez d'envoyer votre demande.

Si le problème persiste, contactez votre responsable de compte Google Play ou envoyez une demande d'assistance. Consultez le tableau de bord d'état Play pour connaître les éventuelles interruptions de service.