REST Resource: purchases.voidedpurchases

Recurso: VoidedPurchase

Um recurso "VoidedPurchase" indica uma compra que foi cancelada/reembolsada/estornada.

Representação JSON 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
Campos
kind

string

Esse tipo representa um objeto de compra anulada no serviço "androidpublisher".
purchaseToken

string

O token que identifica exclusivamente uma compra única ou assinatura. Para identificar exclusivamente as renovações de assinaturas, use o "orderId" (disponível para a versão 3 ou mais recente da API).
purchaseTimeMillis

string (int64 format)

O momento em que a compra foi feita, em milissegundos desde a época (1º de janeiro de 1970).
voidedTimeMillis

string (int64 format)

O momento em que a compra foi cancelada/reembolsada/estornada, em milissegundos desde a época (1º de janeiro de 1970).
orderId

string

O ID do pedido que identifica exclusivamente uma compra única, uma compra de assinatura ou uma renovação de assinatura.
voidedSource

integer

Quem iniciou a compra anulada. Os valores possíveis incluem: 0. Usuário 1. Desenvolvedor, 2. Google
voidedReason

integer

O motivo para o anulamento da compra. Os valores possíveis incluem: 0. Outro, 1. Arrependimento, 2. Não recebido, 3. Com defeito, 4. Compra acidental, 5. Fraude, 6. compra não intencional, 7. Estorno, 8. Unacknowledged_purchase
voidedQuantity

integer

A quantidade anulada como resultado de um reembolso parcial baseado em quantidade. As compras anuladas de reembolsos parciais com base na quantidade só podem ser retornadas quando o valor "includeQuantityBasedPartialRefund" estiver definido como "true".

Métodos

list

 Lista as compras que foram canceladas, reembolsadas ou estornadas.

Códigos de erro

As operações desse recurso retornam os seguintes códigos de erro HTTP:

Código do erro Motivo Descrição Resolução
400 invalidValue Um valor inválido foi fornecido na solicitação. Geralmente, isso é retornado para um token de compra malformado ou inválido. Corrija o valor do campo inválido no corpo ou nos parâmetros da solicitação com base na referência da API.
400 required Um campo ou parâmetro obrigatório está faltando na solicitação. Consulte a documentação da API para garantir que todos os campos e parâmetros obrigatórios estejam incluídos.
403 userInsufficientPermission O usuário não tem permissão suficiente para realizar a operação solicitada. Confira se o usuário autenticado tem as permissões necessárias no Google Play Console. Consulte Como usar uma conta de serviço para mais detalhes.
404 notFound Não foi possível encontrar o recurso solicitado. Verifique se os identificadores (por exemplo, token de compra, nome do pacote, ID do produto, ID da assinatura) estão corretos.
409 concurrentUpdate Houve uma tentativa de atualizar um objeto que está sendo atualizado simultaneamente. Tente de novo com uma espera exponencial. Evite modificações simultâneas no mesmo recurso.
5xx Generic error Erro genérico no servidor do Google Play. Tente fazer a solicitação novamente.

Se o problema persistir, entre em contato com seu gerente de contas do Google Play ou envie uma solicitação de suporte. Confira o Painel de status do Google Play para saber se há falhas conhecidas.