REST Resource: purchases.products

Recurso: ProductPurchase

Un recurso ProductPurchase indica el estado de la compra que hace un usuario de un producto integrado en la aplicación.

Representación JSON 
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
Campos
kind

string

Este tipo representa un objeto inappPurchase en el servicio androidpublisher.
purchaseTimeMillis

string (int64 format)

Es la hora (expresada en milisegundos) en que se compró el producto a partir de la época (desde el 1 de enero de 1970).
purchaseState

integer

Es el estado de compra del pedido. Los valores posibles son los siguientes: 0. Comprado 1. Cancelado 2. Pendiente
consumptionState

integer

Es el estado de consumo del producto integrado en la aplicación. Los valores posibles son los siguientes: 0. Aún sin procesar la compra del consumible 1. Consumiste
developerPayload

string

Es la cadena especificada por el desarrollador que contiene información adicional sobre un pedido.
orderId

string

Es el ID de pedido asociado con la compra del producto integrado en la aplicación.
purchaseType

integer

Es el tipo de compra del producto integrado en la aplicación. Este campo solo se configura si esta compra no se realizó a través del flujo de facturación integrada estándar. Los valores posibles son los siguientes: 0. Prueba (es decir, se compró desde una cuenta de prueba de licencia) 1. Promo (es decir, se compró usando un código promocional) No se incluyen las compras con Puntos de Play. 2. Recompensa (es decir, se obtiene por mirar un anuncio de video en lugar de pagar)
acknowledgementState

integer

Es el estado de procesamiento de la compra del producto integrado en la aplicación. Los valores posibles son los siguientes: 0. Compra aún sin procesar 1. Confirmado
purchaseToken

string

Es el token de compra que se genera para identificar esta compra. Podría no estar presente.
productId

string

Es el SKU del producto integrado en la aplicación. Podría no estar presente.
quantity

integer

Es la cantidad asociada con la compra del producto integrado en la aplicación. Si no está presente, la cantidad es 1.
obfuscatedExternalAccountId

string

Es una versión ofuscada del ID que está asociado de forma única a la cuenta del usuario en tu app. Solo está presente si se especificó con https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid cuando se realizó la compra.
obfuscatedExternalProfileId

string

Es una versión ofuscada del ID que está asociado de forma única al perfil del usuario en tu app. Solo está presente si se especificó con https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid cuando se realizó la compra.
regionCode

string

Es el código regional de facturación (según ISO 3166-1 Alpha-2) del usuario en el momento en que se otorgó el producto.
refundableQuantity

integer

Es la cantidad apta para reembolso, es decir, la cantidad que no se reembolsó. El valor refleja reembolsos parciales basados en cantidades y reembolsos totales.

Métodos

acknowledge

 Procesa la compra de un elemento integrado en una app.

consume

 Procesa la compra de un elemento integrado en una app.

get

 Verifica el estado del consumo y la compra de un elemento integrado en la app.

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 invalidPurchaseState La compra no tiene un estado válido para realizar la operación solicitada. Por ejemplo, es posible que intentes confirmar una compra ya consumida o cancelar una suscripción que no está activa. Verifica el estado actual del recurso con la API de Get correspondiente antes de intentar la operación. Asegúrate de que el recurso se encuentre en un estado adecuado para la acció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 productNotOwnedByUser El token de compra proporcionado es válido, pero el usuario no posee el producto actualmente. Esto puede suceder si la compra se reembolsó, revocó o venció antes de la confirmación. Verifica el estado actual del recurso con la API de Get correspondiente antes de intentar la operación. Asegúrate de que el recurso se encuentre en un estado adecuado para la acción.
400 purchaseTokenMismatch El token de compra proporcionado no coincide con la compra, el nombre del paquete, el ID de suscripción o el ID del producto. Verifica que todos los detalles de la solicitud sean correctos y correspondan entre sí.
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.
400 unsupportedIabType La operación no se admite para el tipo de facturación integrada en la aplicación especificado. Asegúrate de que el método de la API sea compatible con el tipo de elemento que se administra.
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.