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.
}
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. Se establece 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 hora en la que se completó la transacción.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
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.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
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 determinar el cargo de servicio de las apps aptas que participan en los programas de socios. Los desarrolladores que participan en el Programa de Experiencia Multimedia de Play (https://play.google.com/console/about/programs/mediaprogram/) deben proporcionar el código del programa cuando denuncien 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 realizada. Las direcciones (transaction_type) solo pueden ser una de las siguientes opciones:
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.

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 inicia 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 inicia el flujo de facturación alternativa. 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. Las direcciones (product_details) solo pueden ser una de las siguientes opciones:
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.

Enumeraciones
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.

Enumeraciones
SUBSCRIPTION_TYPE_UNSPECIFIED 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.

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

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.