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)
  },

  // 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 (por ejemplo, "com.some.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 al crear 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 aplicaran los reembolsos.
originalTaxAmount

object (Price)

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

object (Price)

Solo salida. El importe actual de la transacción (sin impuestos). Representa el importe actual antes de impuestos, incluido cualquier reembolso que se haya aplicado a esta transacción.
currentTaxAmount

object (Price)

Solo salida. El importe del impuesto actual. Representa el importe del impuesto actual, incluidos los reembolsos que podrían haberse aplicado a esta transacción.
testPurchase

object (ExternalTransactionTestPurchase)

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

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con 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 hora en la que se creó esta transacción. Este es el momento en que se notificó a Google sobre la transacción.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con 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 cálculo de impuestos.
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 es una transacción única y no forma parte de una suscripción.
recurringTransaction

object (RecurringExternalTransaction)

Esta transacción es parte de una serie recurrente de transacciones.

ExternalTransactionTestPurchase

Este tipo no tiene campos.

Representa una transacción que se realiza con una cuenta de prueba. Google no te 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 Create. Recuperado del cliente cuando se inicia el flujo de facturación alternativo.

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

string

Solo entrada. Se proporcionan durante la llamada a Create. Recuperado del cliente cuando se inicia el flujo de facturación alternativo. Obligatorio solo para la compra inicial.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Solo entrada. Se proporcionan 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. 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 externas que experimenta el usuario para completar la transacción.

Enumeradores
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED No se especificó el programa de transacciones. No se usa.
USER_CHOICE_BILLING Facturación a elección del usuario, en la que este 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 como desarrollador o administrador

ExternalSubscription

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

Los tipos de una suscripción externa.

Enumeradores
SUBSCRIPTION_TYPE_UNSPECIFIED No se especifica, no usar.
RECURRING Esta es una suscripción recurrente en la que se le cobra al usuario en cada ciclo de facturación.
PREPAID Esta es 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.

Enumeradores
TRANSACTION_STATE_UNSPECIFIED Estado de la transacción no especificado. No se usa.
TRANSACTION_REPORTED La transacción se denunció correctamente a Google.
TRANSACTION_CANCELED Se reembolsó por completo la transacción.

ExternalTransactionAddress

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

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

string

Obligatorio. Código regional de dos letras basado en 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 es obligatorio para transacciones en la India. Los valores válidos son “ANDAMAN Y NICOBAR ISLA”, “ANDHRA PRADESH”, “ARUNACHAL PRADESH”, “ASSAM”, “BIADUHAR”, “CHANDIJATISGARH”, “CHHATTISKINGHATTISGARH”, “DADRAKASKINGISKING”, “DADRIKAKIAKANDO”, “ARUNACHAL PRADESH”, “ASSAM”.

Métodos

createexternaltransaction

 Crea una transacción externa nueva.

getexternaltransaction

 Obtiene una transacción externa existente.

refundexternaltransaction

 Reembolsa o reembolsa parcialmente una transacción externa existente.