Notas da versão da API

Esta página lista as principais mudanças em cada versão da API Google Pay para Android. As notas da versão estão classificadas e identificadas por data e incluem descrições das alterações.

Março de 2026

• Os cartões de teste do gateway foram expandidos para oferecer suporte a endereços de faturamento de 27 mercados (antes, apenas dos EUA). Isso permite que os comerciantes testem fluxos de pagamento completos com endereços de faturamento específicos de cada país no TEST ambiente. Os mercados adicionados incluem Reino Unido, França, Alemanha, Espanha, Japão, Hong Kong, Brasil e outros 20 países.

Novembro de 2025

• A opção FULL-ISO3166 foi adicionada à propriedade format do objeto BillingAddressParameters, e uma nova propriedade format foi introduzida no objeto ShippingAddressParameters. As propriedades retornadas dos objetos IntermediateAddress e Address foram atualizadas para incluir uma nova propriedade de formato. iso3166AdministrativeArea. Essa mudança não deve causar problemas nas implementações atuais implementações. Consulte as páginas de referência para mais informações.

Outubro de 2025

A versão 19.5.0 da biblioteca da Carteira dos Google Play Services define a versão mínima do SDK como 23 e inclui atualizações de dependência internas.

• Adição de uma nova checkoutOption CONTINUE_TO_REVIEW. Ao usar essa opção, o botão da página de pagamento é rotulado como "Revisar pedido". Consulte a referência de objeto para mais informações.

• Adição de suporte a novos tipos de botões `PIX` e `EWALLET` à API Pay Button.

Versão Beta fechada

• Adição de um novo método de API getPaymentMetdata para buscar metadados relacionados à forma de pagamento preferida de um usuário para melhorar a experiência de pré-finalização de compra. Entre em contato conosco para mais informações sobre esse recurso.

Julho de 2024

A API PayButton agora oferece um recurso de personalização que mostra a rede do cartão do usuário (por exemplo, Visa, Mastercard) e os últimos quatro dígitos do cartão nos seguintes botões de pagamento do Google Pay:

Tipo de botão	Antes	Depois
COMPRAR
PAGAR

Essa melhoria está disponível apenas para usuários que têm um cartão qualificado vinculado à conta do Google Pay.

Maio de 2024

A versão 19.4.0 da biblioteca da Carteira dos Google Play Services define a versão mínima do SDK como 21 e inclui atualizações de dependência internas.

Fevereiro de 2024

Esta versão descontinua o método AutoResolveHelper#resolveTask(Task, Activity, int). Use os novos contratos da API Activity Result introduzidos nesta versão.

Lançamento da versão 19.3.0 da biblioteca da Carteira do Google Play Services, que adiciona suporte à nova API Activity Result no Android com a introdução de novos contratos para processar loadPaymentData resultados de tarefas. Comece a usar a API criando inicializadores de resultados de atividades usando os GetPaymentData e GetPaymentDataResult contratos.

Dezembro de 2023

Versão Beta. Compartilhe feedback pelo Issue Tracker.

Lançamento da versão 19.3.0-beta01 da biblioteca da Carteira dos Google Play Services, que adiciona suporte à nova API Activity Result no Android com a introdução de novos contratos para processar loadPaymentData resultados de tarefas. Comece a usar a API criando inicializadores de resultados de atividades usando os GetPaymentData e GetPaymentDataResult contratos.

Esta versão descontinua o AutoResolveHelper#resolveTask(Task, Activity, int) método. Use os novos contratos da API Activity Result introduzidos nesta versão.

Setembro de 2023

Lançamento da versão 19.2.1 da biblioteca da Carteira dos Google Play Services, que atualiza a API PayButton para usar um recurso de botão estático para usuários com a versão dos Google Play Services anterior à 23.21.0.

Junho de 2023

A API PayButton no Android foi atualizada da versão Beta para a estável, incluindo as seguintes mudanças:

Texto do botão com o mesmo tamanho do logotipo do GPay.
Margens ajustáveis do botão para as alturas mínima e máxima.
Raio do canto configurável para corresponder ao design da interface.

Abril de 2023

Beta:

• Adição de uma API PayButton para Android para gerar botões de pagamento do Google Pay com a marca mais recente do serviço. Consulte a documentação para desenvolvedores com instruções para atualizar para o novo botão de pagamento
.

Fevereiro de 2023

Beta:

• Adição de cartões de teste do gateway para facilitar os testes completos. Os comerciantes podem selecionar um desses cartões para receber um token que pode ser enviado ao ambiente de teste de um processador e receber respostas adequadas. Consulte a documentação do conjunto de cartões de teste.

Fevereiro de 2021

• Adição de AsiaBill, bePaid, ConnexPay, EpicPay, Mixplat, Netopia, PaymentFusion, Pikassa e PSCB à lista de processadores participantes.
• Adição do novo recurso de marca do Google Pay a todos os exemplos em práticas recomendadas de UX.

Janeiro de 2021

• Adição de CardKnox, Cloud9 Gateway de pagamento (C9PG), Corefy, Pay.nl e ReePay à lista de processadores participantes.
• Adição do novo recurso de marca do Google Pay às diretrizes da marca.

Dezembro de 2020

• Adição de ЮKassa, IMOJE, Modulbank, PayNearMe, QIWI e QualPay à lista de processadores participantes.

Novembro de 2020

• Adição de AllPayments, CellPoint Mobile, Evopay e Primer à lista de processadores participantes.
• Adição de instruções para configurar a API Google Pay em conformidade com a Autenticação Segura do Cliente (SCA) à SCA e API Google Pay.

Outubro de 2020

• Adição de InPlat, IntellectMoney, Rebilly, TAS Link e UAPay à lista de processadores participantes.
• Adição de instruções sobre como usar o valor do ID do comerciante TEST para testar a descriptografia com a biblioteca TINK à criptografia de dados de pagamento.

Setembro de 2020

• Adição de Alfa-Bank Ukraine, AsiaPay, Bizzon, Credorax e Payload à lista de processadores participantes.
• Adição de um vídeo que explica a API Google Pay em português do Brasil à visão geral.
• Adição de exemplos de código e exemplos na linguagem de programação Kotlin ao tutorial.
• Adição de instruções para acessar nosso pacote de cartões de teste no ambiente TEST ao pacote de cartões de teste.

Junho de 2020

• Adição de ConcordPay, Payfacto e Radial à lista de processadores participantes.

Maio de 2020

• Adição de Kassa à lista de processadores participantes.
• Adição de figuras de fluxo de pagamento que explicam a relação entre comerciantes, o Google e processadores de pagamento à visão geral.
• Adição de mais informações sobre a referência do cliente isReadytoPay à referência.

Abril de 2020

• Adição de FreedomPay, Paymo, Oceanpayment e PayU India à lista de processadores participantes.

Março de 2020

• Adição de 2C2P, Windcave, dLocal e Paymentwall à lista de processadores participantes.
• Adição de valores de parâmetros de gateway ao tutorial.
• Adição da propriedade allowedCreditCards ao objeto de solicitação CardParameters que permite que os comerciantes filtrem transações de cartão de crédito para referência.
• Adição de instruções para obter acesso de produção usando o registro no Console do Google Pay e da Carteira para solicitar acesso à produção.
• Adição de instruções para entrar em contato com o suporte para dúvidas técnicas e de integração usando o console do Google Pay e da Carteira para como receber ajuda e solução de problemas.

Fevereiro de 2020

• Adição de PayOnline à lista de participantes processadores.

Janeiro de 2020

• Adição de Paygent, Judopay, Paymark, e-SiTef - Software Express e noon payments à lista de processadores participantes.
• Adição de uma visualização de resumo às diretrizes da marca.

Dezembro de 2019

• Adição de Billing Systems, Spreedly, theMAP e APPEX à lista de processadores participantes.
• Adição de requisitos de integração DIRECT à visão geral.

Novembro de 2019

• Adição de Tranzzo, MOBI.Money, Suntech e Best2Pay à lista de processadores participantes.
• Adição de OpenCart à lista de plataformas participantes.

Outubro de 2019

• Adição de instruções para ativar o suporte a cartões combinados de débito e crédito do Brasil na allowedCardNetworks propriedade para o CardParameters objeto de solicitação à Referência.

Setembro de 2019

• Adição de NCCC, eCard e BlueGate (NTTData) à lista de processadores participantes.

Agosto de 2019

• Adição de PayAnyWay, Paragon Payment Solutions e Paylane à lista de processadores participantes.
• Remoção da propriedade merchantId do exemplo de objeto MerchantInfo.
• Adição de CheckoutActivity.java para substituir YourActivity.java ao tutorial.
• Adição de PaymentsUtil.java para substituir GooglePay.java ao tutorial.
• Adição de novas imagens complementares às práticas recomendadas de UX.
• Adição de instruções para personalizar sua integração para conformidade com a SCA a Autenticação Segura do Cliente.

Julho de 2019

• Adição de Cathay United Bank, Chase Merchant Services (antigo Chase Paymentech), LogPay, Nuvei, Payler, Paymetric e RBS à lista de processadores participantes.

Junho de 2019

• Adição de CardConnect, eGHL e LogPay à lista de processadores participantes.
• Adição de um conjunto diversificado de exemplos de tokens de amostra para testar com tokens de amostra.
• Adição de mais informações e exemplos às práticas recomendadas de UX.
• Adição de uma nova opção allowedCardNetworks, INTERAC, ao tutorial.

Maio de 2019

• Adição de Braspag, Ecard, Redsys e Worldnet à lista de processadores participantes.

Abril de 2019

• Adição de Computop, MyCheck, Sipay, TPay.com e Wirecard à lista de gateways compatíveis.
• Adição do PayPal como forma de pagamento compatível na propriedade type para o objeto de solicitação PaymentMethod à referência.

Março de 2019

• Adição de iQmetrix, Portmone e Vindicia à lista de processadores participantes.

Fevereiro de 2019

• Adição de Gestpay, iPay88, MultiCarta, Square e WayForPay à lista de processadores participantes.
• Adição de mais informações sobre criptografia e exemplos de payloads retornados com uma DIRECT integração para Testar com tokens de amostra.
• Adição de perguntas e respostas frequentes sobre produtos e solução de problemas às perguntas frequentes.

Janeiro de 2019

• Adição de Assist, Gateway de pagamento GMO e Moneris à lista de gateways compatíveis.

• Adição de conteúdo localizado nos seguintes idiomas:

  • Russo
  • Português (Brasil)
  • Japonês
  • Polonês
  • Chinês (tradicional)
• Adição de exemplos de processadores participantes à tabela de gateway e gatewayMerchantId propriedades para o TokenizationSpecification objeto de solicitação à referência.

Dezembro de 2018

• Adição do idioma árabe ao recurso "Comprar com o Google Pay" às diretrizes da marca.
• Adição de informações sobre o ECv2, um protocolo de criptografia atualizado que permite que os comerciantes armazenem uma chave de assinatura do Google estática e de longo prazo, que só precisa ser atualizada a cada 10 anos, para DIRECT integrações à criptografia de dados de pagamento.
  Observação: se você implementou o suporte para ECv1, ele continuará funcionando. Caso queira fazer upgrade para o ECv2 em produção, avise seu contato do Google para confirmar sua implementação.
• Adição de informações sobre o suporte a payloads ECv2 para a versão 1.1.0 da biblioteca do Tink às notas de lançamento do Tink.

Novembro de 2018

• Adição do NMI à lista de processadores participantes.
• Adição de mais informações sobre a marca do Google Pay às diretrizes da marca.

Outubro de 2018

• Adição de instruções para rotação de chaves para integrações DIRECT a criptografia de dados de pagamento.

Setembro de 2018

• Adição de informações sobre a APIv2 ao exemplo de código do GitHub.

Agosto de 2018

• Adição de informações sobre a nova versão da API Google Pay, a APIv2, à atualização para a versão mais recente.
  Observação:apps integrados com a APIv1 continuarão funcionando.