- Recurso: ExternalTransaction
- ExternalTransactionTestPurchase
- OneTimeExternalTransaction
- RecurringExternalTransaction
- ExternalTransactionProgram
- ExternalSubscription
- SubscriptionType
- OtherRecurringProduct
- TransactionState
- ExternalTransactionAddress
- ExternalOfferInitialAcquisitionDetails
- Métodos
Recurso: ExternalTransaction
Os detalhes de uma transação externa.
Representação JSON |
---|
{ "packageName": string, "externalTransactionId": string, "originalPreTaxAmount": { object ( |
Campos | |
---|---|
packageName |
Apenas saída. O nome do recurso da transação externa. O nome do pacote do app em que os produtos no app foram vendidos (por exemplo, "com.some.app"). |
externalTransactionId |
Apenas saída. ID desta transação. Todos os IDs de transações com o mesmo nome de pacote precisam ser exclusivos. Defina ao criar a transação externa. |
originalPreTaxAmount |
Obrigatório. O valor original da transação sem tributos. Esse valor representa o valor sem tributos originalmente notificado ao Google antes da aplicação dos reembolsos. |
originalTaxAmount |
Obrigatório. O valor do tributo original. Esse valor representa o valor dos tributos notificados originalmente ao Google antes da aplicação de qualquer reembolso. |
currentPreTaxAmount |
Apenas saída. O valor da transação atual sem tributos. Representa o valor atual sem tributos, incluindo todos os reembolsos que podem ter sido aplicados a essa transação. |
currentTaxAmount |
Apenas saída. O valor dos tributos atuais. Ele representa o valor dos tributos atuais, incluindo os reembolsos que podem ter sido aplicados a essa transação. |
testPurchase |
Apenas saída. Se definido, significa que a transação foi uma compra de teste. O Google não vai cobrar por uma transação de teste. |
transactionTime |
Obrigatório. A hora em que a transação foi concluída. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
createTime |
Apenas saída. A hora em que esta transação foi criada. É o momento em que o Google foi notificado sobre a transação. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
transactionState |
Apenas saída. O estado atual da transação. |
userTaxAddress |
Obrigatório. Endereço do usuário para cálculo de tributos. |
transactionProgramCode |
Opcional. O código do programa de transações usado para ajudar a determinar a taxa de serviço dos apps qualificados que participam de programas de parcerias. Os desenvolvedores que participam do Programa Play Media Experience (https://play.google.com/console/about/programs/mediaprogram/) precisam informar o código do programa ao informar transações de faturamento alternativo. Se você for um desenvolvedor qualificado, entre em contato com o BDM para mais informações sobre como definir esse campo. Observação: este campo não pode ser usado para transações de promoções externas. |
externalOfferInitialAcquisitionDetails |
Opcional. Detalhes sobre a primeira vez que um usuário/dispositivo concluiu uma transação usando promoções externas. Não é obrigatório para transações feitas usando apenas a escolha de faturamento do usuário ou o faturamento alternativo. |
Campo de união transaction_type . O tipo de transação que foi realizada. transaction_type pode ser apenas de um dos tipos a seguir: |
|
oneTimeTransaction |
Essa transação é única e não faz parte de uma assinatura. |
recurringTransaction |
Esta transação faz parte de uma série recorrente de transações. |
ExternalTransactionTestPurchase
Esse tipo não tem campos.
Representa uma transação realizada usando uma conta de teste. Essas transações não serão cobradas do Google.
OneTimeExternalTransaction
Representa uma transação única.
Representação JSON |
---|
{ "externalTransactionToken": string } |
Campos | |
---|---|
externalTransactionToken |
Somente entrada. Fornecidos durante a chamada para criar. Recuperado do cliente quando o fluxo de faturamento alternativo é iniciado. |
RecurringExternalTransaction
Representa uma transação que faz parte de uma série recorrente de pagamentos. Pode ser uma assinatura ou um produto único com vários pagamentos (como comprar na pré-venda).
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união
|
|
initialExternalTransactionId |
O ID da transação externa da primeira transação desta série recorrente de transações. Por exemplo, para uma assinatura, esse seria o ID da transação do primeiro pagamento. Obrigatório ao criar transações externas recorrentes. |
externalTransactionToken |
Somente entrada. Fornecidos durante a chamada para criar. Recuperado do cliente quando o fluxo de faturamento alternativo é iniciado. Obrigatório apenas para a compra inicial. |
migratedTransactionProgram |
Somente entrada. Fornecidos durante a chamada para criar. Use apenas ao migrar uma assinatura de relatórios mensais manuais para relatórios automáticos. |
Campo de união product_details . Obrigatório. Detalhes do produto na transação externa recorrente. product_details pode ser apenas de um dos tipos a seguir: |
|
externalSubscription |
Detalhes de uma assinatura externa. |
otherRecurringProduct |
Detalhes de um produto de transação externa recorrente que não pertence a nenhuma outra categoria específica. |
ExternalTransactionProgram
Representa o programa de transação externa experimentado pelo usuário para concluir a transação.
Enums | |
---|---|
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED |
Programa de transação não especificado. Não utilizado. |
USER_CHOICE_BILLING |
Escolha de faturamento do usuário, em que o usuário pode escolher entre o faturamento gerenciado pelo desenvolvedor do Google Play Faturamento. |
ALTERNATIVE_BILLING_ONLY |
Somente faturamento alternativo, em que os usuários só podem usar o faturamento de gerente do desenvolvedor. |
ExternalSubscription
Detalhes de uma assinatura externa.
Representação JSON |
---|
{
"subscriptionType": enum ( |
Campos | |
---|---|
subscriptionType |
Obrigatório. O tipo de assinatura externa. |
SubscriptionType
Os tipos de uma assinatura externa.
Enums | |
---|---|
SUBSCRIPTION_TYPE_UNSPECIFIED |
Não especificado, não use. |
RECURRING |
Essa é uma assinatura recorrente em que o usuário é cobrado a cada ciclo de faturamento. |
PREPAID |
É uma assinatura pré-paga em que o usuário paga adiantado. |
OtherRecurringProduct
Esse tipo não tem campos.
Detalhes de um produto de transação externa recorrente que não pertence a nenhuma outra categoria mais específica.
TransactionState
O estado de uma transação que está sendo feita.
Enums | |
---|---|
TRANSACTION_STATE_UNSPECIFIED |
Estado da transação não especificado. Não utilizado. |
TRANSACTION_REPORTED |
A transação foi denunciada ao Google. |
TRANSACTION_CANCELED |
A transação foi totalmente reembolsada. |
ExternalTransactionAddress
Endereço do usuário para a transação externa.
Representação JSON |
---|
{ "regionCode": string, "administrativeArea": string } |
Campos | |
---|---|
regionCode |
Obrigatório. Código regional de duas letras com base no ISO-3166-1 Alfa-2 (códigos de região das Nações Unidas). |
administrativeArea |
Opcional. Subdivisão administrativa de nível superior do país/região. Obrigatório apenas para transações na Índia. Os valores válidos são "ANDAMAN AND NICOBAR NICOBAR ISLANDS E NICOBAR ILOBAR ISLANDS, "ANDAMAN AND NICOBAR |
ExternalOfferInitialAcquisitionDetails
Detalhes sobre a primeira vez que um usuário/dispositivo concluiu uma transação usando promoções externas.
Representação JSON |
---|
{ "externalTransactionId": string } |
Campos | |
---|---|
externalTransactionId |
Obrigatório. O ID da transação externa da primeira compra concluída feita pelo usuário. |
Métodos |
|
---|---|
|
Cria uma nova transação externa. |
|
Recebe uma transação externa existente. |
|
Reembolsa ou reembolsa parcialmente uma transação externa existente. |