REST Resource: externaltransactions

Recurso: ExternalTransaction

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,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

  // 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. 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 la aplicación (por ejemplo, "com.alguna.app").

externalTransactionId

string

Solo salida. Es el ID de esta transacción. Todos los ID 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 sin impuestos. Representa el importe antes de impuestos que se notificó originalmente a Google antes de que se aplicara 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 aplicara cualquier reembolso.

currentPreTaxAmount

object (Price)

Solo salida. Es el importe actual de la transacción sin impuestos. Representa el importe antes de impuestos actual, incluidos los reembolsos que se podrían haber aplicado a esta transacción.

currentTaxAmount

object (Price)

Solo salida. Es el importe del impuesto actual. Representa el importe del impuesto actual, incluidos los reembolsos que se podrían haber aplicado a esta transacción.

testPurchase

object (ExternalTransactionTestPurchase)

Solo salida. Si se configura, esta transacción fue una compra de prueba. Google no cobrará por las transacciones de prueba.

transactionTime

string (Timestamp format)

Obligatorio. Indica 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. Indica la hora a la que se creó esta transacción. Es el momento en que Google recibió la notificación 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. Dirección del usuario para el procesamiento de impuestos.

transactionProgramCode

integer

Opcional. Es el código del programa de transacciones, que se usa para determinar los cargos del servicio de las apps aptas que participan en los programas de socios. Los desarrolladores que participan en el programa 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 utilizar para transacciones de ofertas externas.

externalOfferInitialAcquisitionDetails

object (ExternalOfferInitialAcquisitionDetails)

Opcional. Detalles sobre la primera vez que un usuario o dispositivo completó una transacción con ofertas externas. No se requiere para transacciones realizadas solo con facturación a elección del usuario o facturación alternativa.

Campo de unión transaction_type. Es el tipo de transacción que se realizó. Las direcciones (transaction_type) solo pueden ser una de las siguientes opciones:
oneTimeTransaction

object (OneTimeExternalTransaction)

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

recurringTransaction

object (RecurringExternalTransaction)

Esta transacción forma parte de una serie recurrente.

ExternalTransactionTestPurchase

Este tipo no tiene campos.

Representa una transacción realizada con una cuenta de prueba. Google no cobrará estas transacciones.

OneTimeExternalTransaction

Representa una transacción única.

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

string

Solo entrada. Se proporcionan durante la llamada a Crear. 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 (como el pedido anticipado).

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 transacción externo de la primera transacción de esta serie de transacciones recurrentes. Por ejemplo, para una suscripción, este sería el ID de transacción del primer pago. Es obligatorio cuando se crean transacciones externas recurrentes.

externalTransactionToken

string

Solo entrada. Se proporcionan durante la llamada a Crear. Se recupera del cliente cuando se inicia el flujo de facturación alternativa. Obligatorio solo para la compra inicial.

migratedTransactionProgram

enum (ExternalTransactionProgram)

Solo entrada. Se proporcionan durante la llamada a Crear. Solo se debe usar 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)

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 externo que experimenta el usuario para completar la transacción.

Enumeraciones
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Programa de transacciones no especificado. No se usa.
USER_CHOICE_BILLING Facturación a elección del usuario, en la que un usuario puede elegir entre la facturación administrada por el desarrollador de la Facturación Google Play
ALTERNATIVE_BILLING_ONLY Solo facturación alternativa, en la que los usuarios solo pueden usar la facturación del administrador del desarrollador

ExternalSubscription

Detalles de una suscripción externa.

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

enum (SubscriptionType)

Obligatorio. El tipo de suscripción externa.

SubscriptionType

Los tipos de una suscripción externa.

Enumeraciones
SUBSCRIPTION_TYPE_UNSPECIFIED No se especifica, no se debe usar.
RECURRING Es una suscripción recurrente en la que se le cobra al usuario en cada ciclo de facturación.
PREPAID Se trata de una suscripción prepagada 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 Estado de transacción sin especificar. No se usa.
TRANSACTION_REPORTED La transacción se informó correctamente a Google.
TRANSACTION_CANCELED Se reembolsó por completo la transacción.

ExternalTransactionAddress

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

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

string

Obligatorio. Es un código regional de dos letras basado en la norma ISO-3166-1 alfa-2 (códigos regionales de la ONU).

administrativeArea

string

Opcional. Subdivisión administrativa de nivel superior del país o la región. Solo se requiere para transacciones en India.

ExternalOfferInitialAcquisitionDetails

Detalles sobre la primera vez que un usuario o dispositivo completó una transacción con ofertas externas.

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

string

Obligatorio. Es el ID de transacción externo de la primera compra completada por el usuario.

Métodos

createexternaltransaction

Crea una transacción externa nueva.

getexternaltransaction

Obtiene una transacción externa existente.

refundexternaltransaction

Reembolsa o reembolsa de forma parcial una transacción externa existente.