Method: orders.reviewrefund

Proporciona la preferencia de reembolso y el uso de la compra para una solicitud de devolución del cargo

Solicitud HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:reviewrefund

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
packageName

string

Obligatorio. Es el nombre del paquete de la aplicación para la que se compró esta suscripción o elemento integrado en la app (por ejemplo, "com.alguna.cosa").
orderId

string

Obligatorio. Es el ID de pedido que se proporcionó al usuario cuando se compró la suscripción o el pedido en la app.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
Campos
pendingRefundToken

string

Obligatorio. Es el token de reembolso pendiente que se incluye en la notificación de revisión de reembolso pendiente.
sampleContentProvided

boolean

Obligatorio. Indica si proporcionaste una muestra gratuita, una prueba o información sobre la funcionalidad antes de la compra.
refundPreference

enum (RefundPreference)

Obligatorio. Indica tu preferencia, según tu lógica operativa, sobre si Play Store debe otorgar el reembolso.
consumptionPercentageMilliunits

integer

Opcional. Es el porcentaje de la compra directa desde la aplicación que consumió el cliente, en miliunidades. Mínimo: 0 Máximo: 100,000. En el caso de las apps pagadas, se puede omitir. Ejemplo : 45200 representa el 45.2%.
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

Opcional. Es una lista de eventos, en la que cada uno representa una instancia en la que el usuario consumió o usó el elemento o servicio comprado. Se rechazarán las listas con más de 1,000 elementos.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/androidpublisher

RefundPreference

Indica tu preferencia, según tu lógica operativa, sobre si Play Store debe otorgar el reembolso.

Enums
REFUND_PREFERENCE_UNSPECIFIED Indica que no se especificó la preferencia de reembolso del pedido. Este valor no se usa.
DECLINE El desarrollador prefiere que Play rechace el reembolso.
APPROVE El desarrollador prefiere que Play otorgue el reembolso completo.
NEUTRAL El desarrollador no tiene preferencias sobre la decisión de Google Play de emitir un reembolso

ConsumptionUsageEvent

Es una lista de eventos, en la que cada uno representa una instancia en la que el usuario consumió o usó el elemento o servicio comprado.

Representación JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
Campos
obfuscatedAccountId

string

Opcional. Es una cadena ofuscada que se asocia de forma única con la cuenta de usuario del comprador en la app. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

Opcional. Es una cadena ofuscada que se asocia de forma única con el perfil de usuario del comprador en la app. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

Opcional. Fecha y hora en que el usuario consumió, usó, descargó, abrió o transmitió el contenido.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
ipAddress

string

Opcional. Es la dirección IP desde la que se produjo el consumo.
consumptionItemDescription

string

Opcional. Texto de formato libre que permite a los desarrolladores proporcionar más información sobre el elemento consumido. La longitud máxima es de 5,000 caracteres.
location

object (CoarseLocation)

Opcional. Ubicación geográfica en la que se produjo el consumo.

CoarseLocation

Son los detalles de la ubicación geográfica aproximada en la que se produjo el consumo.

Representación JSON 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
Campos
regionCode

string

Obligatorio. Es el código de región de CLDR del país o la región de la dirección. Este valor nunca se infiere, y debes asegurarte de que sea correcto. Ejemplo: "CH" para Suiza.
administrativeArea

string

Opcional. División administrativa más alta que se usa para las direcciones postales de un país o una región. Por ejemplo, puede ser un estado, una provincia, una óblast o una prefectura. En el caso de España, se trata de la provincia y no de la comunidad autónoma (por ejemplo, "Barcelona" y no "Cataluña"). Muchos países no usan un área administrativa en las direcciones postales. Por ejemplo, en Suiza, este campo debe quedar vacío.
locality

string

Opcional. Por lo general, se refiere a la parte de la dirección que indica la ciudad. Ejemplos: ciudad de EE.UU., comuna de Italia o ciudad postal en el Reino Unido. En las regiones del mundo en que las localidades no están bien definidas o no se ajustan bien a esta estructura, deja locality vacío.
sublocality

string

Opcional. Sublocalidad de la dirección. Por ejemplo, puede ser un barrio, un distrito o una zona. En la mayoría de las direcciones, puedes omitir este campo.