- Recurso: ExternalTransaction
- ExternalTransactionTestPurchase
- OneTimeExternalTransaction
- RecurringExternalTransaction
- ExternalTransactionProgram
- ExternalSubscription
- SubscriptionType
- OtherRecurringProduct
- TransactionState
- ExternalTransactionAddress
- Métodos
Recurso: ExternalTransaction
Los detalles de una transacción externa.
Representación JSON |
---|
{ "packageName": string, "externalTransactionId": string, "originalPreTaxAmount": { object ( |
Campos | |
---|---|
packageName |
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 |
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 |
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 |
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 |
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 |
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 |
Solo salida. Si se configura, esta transacción fue una compra de prueba. Google no cobrará por las transacciones de prueba. |
transactionTime |
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: |
createTime |
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: |
transactionState |
Solo salida. Es el estado actual de la transacción. |
userTaxAddress |
Obligatorio. Dirección del usuario para el procesamiento de impuestos. |
transactionProgramCode |
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. |
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 |
Esta transacción es única y no forma parte de una suscripción. |
recurringTransaction |
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 |
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 |
Campos | |
---|---|
Campo de unión
|
|
initialExternalTransactionId |
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 |
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 |
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 |
Detalles de una suscripción externa. |
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 ( |
Campos | |
---|---|
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 |
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 |
Opcional. Subdivisión administrativa de nivel superior del país o la región. Solo se requiere para transacciones en India. |
Métodos |
|
---|---|
|
Crea una transacción externa nueva. |
|
Obtiene una transacción externa existente. |
|
Reembolsa o reembolsa de forma parcial una transacción externa existente. |