REST Resource: purchases.voidedpurchases

Recurso: VoidedPurchase

El recurso VoidedPurchase indica una compra que se canceló o reembolsó, o para la cual se generó una devolución del cargo.

Representación JSON 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
Campos
kind

string

Este tipo representa un objeto de compra anulada en el servicio androidpublisher.
purchaseToken

string

Es el token que identifica de forma única una suscripción o compra única. Para identificar de forma única renovaciones de suscripciones, usa orderId (disponible a partir de la versión 3 de la API).
purchaseTimeMillis

string (int64 format)

Fecha y hora en la que se hizo la compra, expresada en milisegundos desde la época (1 de enero de 1970).
voidedTimeMillis

string (int64 format)

Fecha y hora en la que una compra se canceló o reembolsó, o en la cual se devolvió el cargo correspondiente, expresada en milisegundos desde la época (1 de enero de 1970).
orderId

string

ID de pedido que identifica de forma única una compra única, o una renovación o compra de suscripción.
voidedSource

integer

Iniciador de una compra anulada. Los valores posibles son los siguientes: 0. Usuario 1. Desarrollador 2. Google
voidedReason

integer

Motivo por el que se anuló una compra. Los valores posibles son los siguientes: 0. Otro 1. Arrepentimiento 2. No recibida 3. Defectuosa 4. Compra accidental 5. Fraude 6. Friendly_fraud 7. Devolución del cargo 8. Unacknowledged_purchase
voidedQuantity

integer

Cantidad anulada como resultado de un reembolso parcial basado en cantidad. Las compras anuladas asociadas a reembolsos parciales basados en cantidad solo pueden devolverse si includeQuantityBasedPartialRefund está definido como verdadero.

Métodos

list

 Enumera las compras que se cancelaron o reembolsaron, o para las cuales se generó una devolución del cargo.

Códigos de error

Las operaciones de este recurso devuelven los siguientes códigos de error HTTP:

Código de error Motivo Descripción Solución
400 invalidValue Se proporcionó un valor no válido en la solicitud. A menudo, se devuelve para un token de compra con formato incorrecto o no válido. Corrige el valor del campo no válido en el cuerpo o los parámetros de la solicitud según la referencia de la API.
400 required Falta un campo o parámetro obligatorio en la solicitud. Consulta la documentación de la API para asegurarte de que se incluyan todos los campos y parámetros obligatorios.
403 userInsufficientPermission El usuario no tiene permisos suficientes para realizar la operación solicitada. Asegúrate de que el usuario autenticado tenga los permisos necesarios en Google Play Console. Consulta Cómo usar una cuenta de servicio para obtener más detalles.
404 notFound No se encontró el recurso solicitado. Verifica que los identificadores (p.ej., token de compra, nombre del paquete, ID de producto, ID de suscripción) sean correctos.
409 concurrentUpdate Se intentó actualizar un objeto que se está actualizando de forma simultánea. Vuelve a intentarlo con una retirada exponencial. Evita las modificaciones simultáneas en el mismo recurso.
5xx Generic error Error genérico en el servidor de Google Play. Vuelve a intentar enviar tu solicitud.

Si el problema persiste, comunícate con tu administrador de cuentas de Google Play o envía una solicitud de asistencia. Considera consultar el Panel de estado de Play para ver si hay interrupciones conocidas.