REST Resource: externaltransactions

Recurso: ExternalTransaction

Son los detalles de una transacción externa.

Representación JSON 
{
  "packageName": string,
  "externalTransactionId": string,
  "originalPreTaxAmount": {
    object (Price)
  },
  "originalTaxAmount": {
    object (Price)
  },
  "currentPreTaxAmount": {
    object (Price)
  },
  "currentTaxAmount": {
    object (Price)
  },
  "testPurchase": {
    object (ExternalTransactionTestPurchase)
  },
  "transactionTime": string,
  "createTime": string,
  "transactionState": enum (TransactionState),
  "userTaxAddress": {
    object (ExternalTransactionAddress)
  },
  "transactionProgramCode": integer,

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.

  // Union field program_details can be only one of the following:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  }
  // End of list of possible types for union field program_details.
}
Campos
packageName

string

Solo salida. Es el nombre del recurso de la transacción externa. Es el nombre del paquete de la aplicación en la que se vendieron los productos integrados en ella (por ejemplo, "com.algo.app").
externalTransactionId

string

Solo salida. Es el ID de esta transacción. Todos los IDs de transacción con el mismo nombre de paquete deben ser únicos. El valor se define cuando se crea la transacción externa.
originalPreTaxAmount

object (Price)

Obligatorio. Es el importe original de la transacción antes de impuestos. Representa el importe previo a la aplicación de impuestos que se notificó originalmente a Google antes de que se efectuara cualquier reembolso.
originalTaxAmount

object (Price)

Obligatorio. Es el importe original del impuesto. Representa el importe del impuesto que se notificó originalmente a Google antes de que se efectuara cualquier reembolso.
currentPreTaxAmount

object (Price)

Solo salida. Es el importe de la transacción actual antes de impuestos. Representa el importe actual previo a la aplicación de impuestos, que incluye cualquier reembolso que se haya efectuado de esta transacción.
currentTaxAmount

object (Price)

Solo salida. Es el importe actual del impuesto. Representa el importe actual del impuesto, que incluye cualquier reembolso que se haya efectuado de esta transacción.
testPurchase

object (ExternalTransactionTestPurchase)

Solo salida. Si se definió, esta transacción era una compra de prueba. Google no cobrará ningún cargo por una transacción de prueba.
transactionTime

string (Timestamp format)

Obligatorio. Es la fecha y hora en la que se completó la transacción.

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".
createTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se creó esta transacción. Esta es la fecha y hora en que se notificó a Google acerca de la transacción.

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".
transactionState

enum (TransactionState)

Solo salida. Es el estado actual de la transacción.
userTaxAddress

object (ExternalTransactionAddress)

Obligatorio. Es la dirección del usuario para el cálculo de impuestos.
transactionProgramCode

integer

Opcional. Es el código del programa de transacciones que se usa para ayudar a determinar el cargo de servicio de las apps aptas que participan en programas para socios. Los desarrolladores que participen en el Programa de Play Media Experience (https://play.google.com/console/about/programs/mediaprogram/) deben proporcionar el código del programa cuando informen transacciones de facturación alternativa. Si eres un desarrollador apto, comunícate con tu BDM para obtener más información sobre cómo configurar este campo. Nota: Este campo no se puede usar para transacciones de ofertas externas.
Campo de unión transaction_type. Es el tipo de transacción que se realizó. transaction_type puede ser solo uno de los parámetros siguientes:
oneTimeTransaction

object (OneTimeExternalTransaction)

Esta es una transacción única y no forma parte de una suscripción.
recurringTransaction

object (RecurringExternalTransaction)

Esta transacción forma parte de una serie de transacciones recurrentes.
Campo de unión program_details. Son los detalles específicos del programa que son necesarios para generar informes de transacciones. Los detalles solo deben establecerse para el programa con el que se asocia la transacción. program_details puede ser solo uno de los parámetros siguientes:
externalOfferDetails

object (ExternalOfferDetails)

Opcional. Son los detalles necesarios para informar con precisión las transacciones de ofertas externas.

ExternalTransactionTestPurchase

Este tipo no tiene campos.

Representa una transacción que se realiza con una cuenta de prueba. Google no cobra ningún cargo por estas transacciones.

OneTimeExternalTransaction

Representa una transacción única.

Representación JSON 
{
  "externalTransactionToken": string
}
Campos
externalTransactionToken

string

Solo entrada. Se proporciona durante la llamada a Create. Se recupera del cliente cuando se lanza el flujo de facturación alternativa.

RecurringExternalTransaction

Representa una transacción que forma parte de una serie de pagos recurrentes. Puede ser una suscripción o un producto único con varios pagos (por ejemplo, un pedido por adelantado).

Representación JSON 
{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of list of possible types for union field product_details.
}
Campos

Campo de unión source.

source puede ser una de las siguientes opciones:
initialExternalTransactionId

string

Es el ID de la primera transacción externa de esta serie de transacciones recurrentes. Por ejemplo, para una suscripción, sería el ID de transacción del primer pago. Es obligatorio cuando se crean transacciones externas recurrentes.
externalTransactionToken

string

Solo entrada. Se proporciona durante la llamada a Create. Se recupera del cliente cuando se lanza el flujo de facturación alternativa. Solo es obligatorio para la compra inicial.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Solo entrada. Se proporciona durante la llamada a Create. Solo debe usarse cuando se migra una suscripción de informes mensuales manuales a informes automatizados.
Campo de unión product_details. Obligatorio. Son los detalles del producto en la transacción externa recurrente. product_details puede ser solo uno de los parámetros siguientes:
externalSubscription

object (ExternalSubscription)

Son los detalles de una suscripción externa.
otherRecurringProduct

object (OtherRecurringProduct)

Son los detalles de un producto de transacción externa recurrente que no pertenece a ninguna otra categoría específica.

ExternalTransactionProgram

Representa el programa de transacciones externas que experimenta el usuario para completar la transacción.

Enums
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Indica que no se especificó el programa de transacciones. No se usa.
USER_CHOICE_BILLING Es la facturación a elección del usuario, en la que este puede elegir entre la Facturación Google Play y la facturación administrada por el desarrollador.
ALTERNATIVE_BILLING_ONLY Es solo la facturación alternativa, en la que los usuarios pueden usar únicamente la facturación de administrador y desarrollador.

ExternalSubscription

Son los detalles de una suscripción externa.

Representación JSON 
{
  "subscriptionType": enum (SubscriptionType)
}
Campos
subscriptionType

enum (SubscriptionType)

Obligatorio. Es el tipo de suscripción externa.

SubscriptionType

Son los tipos de suscripciones externas.

Enums
SUBSCRIPTION_TYPE_UNSPECIFIED Indica que no se especificó el valor. No se debe usar.
RECURRING Esta es una suscripción recurrente en la que se cobra al usuario en cada ciclo de facturación.
PREPAID Esta es una suscripción de prepago en la que el usuario paga por adelantado.

OtherRecurringProduct

Este tipo no tiene campos.

Son los detalles de un producto de transacción externa recurrente que no pertenece a ninguna otra categoría más específica.

TransactionState

Es el estado de una transacción que se realiza.

Enums
TRANSACTION_STATE_UNSPECIFIED Indica que no se especificó el estado de la transacción. No se usa.
TRANSACTION_REPORTED Indica que la transacción se informó correctamente a Google.
TRANSACTION_CANCELED Indica que la transacción se reembolsó por completo.

ExternalTransactionAddress

Es la dirección del usuario para la transacción externa.

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

string

Obligatorio. Es el código de región de dos letras según la norma ISO-3166-1 Alpha-2 (códigos de región de Naciones Unidas).
administrativeArea

string

Opcional. Es la subdivisión administrativa principal del país o la región. Solo es obligatorio para transacciones en la India. Los valores válidos son "ANDAMAN AND NICOBAR ISLANDS", "ANDHRA PRADESH", "ARUNACHAL PRADESH", "ASSAM", "BIHAR", "CHANDIGARH", "CHHATTISGARH", "DADRA AND NAGAR HAVELI", "DADRA AND NAGAR HAVELI AND DAMAN AND DIU", "DAMAN AND DIU", "DELHI", "GOA", "GUJARAT", "HARYANA", "HIMACHAL PRADESH", "JAMMU AND KASHMIR", "JHARKHAND", "KARNATAKA", "KERALA", "LADAKH", "LAKSHADWEEP", "MADHYA PRADESH", "MAHARASHTRA", "MANIPUR", "MEGHALAYA", "MIZORAM", "NAGALAND", "ODISHA", "PUDUCHERRY", "PUNJAB", "RAJASTHAN", "SIKKIM", "TAMIL NADU", "TELANGANA", "TRIPURA", "UTTAR PRADESH", "UTTARAKHAND" y "WEST BENGAL".

ExternalOfferDetails

Son los detalles de los informes exclusivos del programa de ofertas externas.

Representación JSON 
{
  "linkType": enum (ExternalOfferLinkType),
  "installedAppPackage": string,
  "installedAppCategory": enum (ExternalOfferAppCategory),
  "appDownloadEventExternalTransactionId": string
}
Campos
installedAppPackage

string

Opcional. Es el nombre del paquete de la app que se descargó a través de esta transacción. Se requiere cuando linkType es LINK_TO_APP_DOWNLOAD.
installedAppCategory

enum (ExternalOfferAppCategory)

Opcional. Es la categoría de la app descargada a través de esta transacción. Debe coincidir con la categoría proporcionada en Play Console durante el proceso de verificación de la app externa. Solo se requiere para las descargas de aplicaciones.
appDownloadEventExternalTransactionId

string

Opcional. Es el ID de transacción externa asociado al evento de descarga de la app a través de un vínculo externo. Es obligatorio cuando se informan transacciones realizadas en apps instaladas de forma externa.

ExternalOfferLinkType

Es el tipo de vínculo externo.

Enums
LINK_TO_DIGITAL_CONTENT_OFFER Es una oferta para comprar contenido digital.

ExternalOfferAppCategory

Categoría de la app descargada. Consulta https://support.google.com/googleplay/android-developer/answer/9859673 para obtener más información sobre las categorías de apps.

Enums
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED Indica que no se especificó el valor. No se debe usar.
APP La app se clasifica en la categoría de la app.
GAME La app se clasifica en la categoría de juegos.

Métodos

createexternaltransaction

 Crea una nueva transacción externa.

getexternaltransaction

 Obtiene una transacción externa existente.

refundexternaltransaction

 Reembolsa completa o parcialmente una transacción externa existente.

Códigos de error

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

Código de error Motivo Solución
5xx 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.
409 Error de actualización de simultaneidad.

Se intentó actualizar un objeto que ya se estaba actualizando. Por ejemplo, una compra se confirma llamando al método acknowledgePurchase() de la Biblioteca de Facturación Play y al método purchases.products.acknowledge de la API de Play Developer al mismo tiempo.

 Vuelve a intentar enviar tu solicitud.