Os desenvolvedores qualificados podem oferecer aos usuários em determinados países um sistema alternativo de faturamento no app e informar as transações resultantes ao Google. Dependendo de onde você distribui seu app e da qualificação, há duas versões de faturamento alternativo que podem ser criadas por app:
- Faturamento alternativo com escolha do usuário: o app oferece um faturamento alternativo junto com o sistema de faturamento do Google Play.
- Faturamento alternativo exclusivo (sem escolha do usuário): o app oferece um sistema alternativo de faturamento sem a presença do Google Play Faturamento como opção.
Este guia aborda as APIs que precisam ser usadas em qualquer uma das ofertas. Consulte as páginas do programa e inscreva-se em programas relevantes antes de usar essas APIs.
Glossário de termos
Convenções de termos seguidas por este guia:
- APIs de faturamento alternativo: APIs usadas para mostrar qualquer tela aplicável aos usuários e permitir que os desenvolvedores informem as transações concluídas no sistema alternativo de faturamento do desenvolvedor.
- Sistema alternativo de faturamento: é o sistema alternativo de faturamento de um desenvolvedor que pode ser oferecido junto com o do Google Play ou por conta própria (sujeito a requisitos de qualificação).
- Transação externa: uma transação que ocorre fora do sistema de faturamento do Google Play.
- Token de transação externa: um token fornecido ao desenvolvedor pela Biblioteca Play Faturamento a ser usado quando o usuário concluir a compra em um sistema alternativo de faturamento. Esse token é usado para notificar o Google Play sobre uma compra.
- ID da transação externo: um identificador exclusivo gerado pelo desenvolvedor para identificar uma transação.
Como oferecer o faturamento alternativo com escolha do usuário
Esta seção descreve como oferecer aos usuários um método de faturamento alternativo com a opção de usar o sistema de faturamento do Google Play. Antes de usar essas APIs, lembre-se de:
- Revisar os requisitos de qualificação dos programas relevantes e concluir as etapas de integração descritas em Noções básicas sobre a escolha de faturamento do usuário no Google Play.
- Integrar a Biblioteca Play Faturamento 5.2 ou uma versão mais recente.
Os demais módulos recomendados de integração do Google Play Faturamento são os mesmos que os desenvolvedores já usariam para a integração atual.
Além disso, recomendamos que você tenha uma configuração de integração da API Google Play Developer pronta, porque ela será usada pela integração de back-end.
Como configurar no Play Console
Os desenvolvedores que concluíram a inscrição no programa de faturamento alternativo com a escolha do usuário correspondente e estão integrados às APIs de faturamento alternativo podem gerenciar as configurações de faturamento alternativo no Play Console:
- Para cada um dos apps qualificados, você pode escolher se quer oferecer um sistema alternativo de faturamento ou não.
- Faça upload dos logotipos das formas de pagamento de acordo com as diretrizes, seguindo todas as especificações de formato. As imagens que não estiverem em conformidade com essas diretrizes não serão mostradas para o sistema alternativo de faturamento na tela de escolha do usuário. (Observação: incluir logotipos das formas de pagamento é opcional, mas altamente recomendado.)
- Se você oferecer assinaturas, informe o link de gerenciamento necessário.
![](https://developer.android.com/static/images/google/play/billing/alternative/alt-bill-settings.png?authuser=9&hl=pt)
Experiência do usuário
As APIs do lado do cliente oferecem estas funcionalidades:
- O Google Play renderiza e gerencia as informações aplicáveis e as telas de escolha do usuário
- Se o usuário optar por usar o sistema de faturamento do Google Play, o fluxo de faturamento continuará usando a interface padrão de faturamento do Google Play.
![]() App do desenvolvedor. |
![]() Tela de escolha de faturamento. |
Exemplo com fins ilustrativos.
Tela de escolha do usuário
A tela de escolha do usuário apresenta a opção de usar o sistema alternativo de faturamento do desenvolvedor ou o sistema de faturamento do Google Play.
Anatomia de uma opção de faturamento alternativo
A opção de faturamento alternativo na tela de escolha do usuário inclui estes elementos da interface:
- Ícone do app.
- Nome do app.
- Recurso de imagem que inclui formas de pagamento oferecidas pelo desenvolvedor.
- Indicador extra (o elemento de interface e mais não faz parte do recurso de imagem).
Recurso de imagem para formas de pagamento
O recurso de imagem único é composto por vários cards de forma de pagamento e precisa seguir as especificações definidas nestas diretrizes.
Dimensões |
192 dp X 20 dp |
Espaçamento entre cards |
8 dp |
Formato do arquivo |
PNG, plano de fundo transparente |
Variações de forma de pagamento
Os desenvolvedores podem escolher o número de ícones das formas de pagamento que querem incluir no recurso de imagem, até um máximo de 5.
Nenhuma outra imagem ou texto pode ser incluído na imagem.
Especificações do card
Os cards de forma de pagamento incluídos no recurso de imagem precisam seguir as diretrizes de tamanho, espaçamento e estilo abaixo.
Dimensões do card | 32 dp X 20 dp |
Padding interno | 3 dp |
Contorno | 1 dp (traço interno incluído nas dimensões), raio 2 dp, #E0E0E0 |
Plano de fundo do card | Cor sólida (preferencialmente branca) |
Próximas etapas
Para começar a integrar as APIs de faturamento alternativo com a escolha do usuário, siga os guias detalhados sobre integração no app e integração de back-end.
Como oferecer apenas o faturamento alternativo
Esta seção descreve como oferecer aos usuários um método de faturamento alternativo sem a opção de usar o sistema de faturamento do Google Play. Antes de usar essas APIs, lembre-se de:
- Analisar os requisitos e se inscrever no programa de faturamento alternativo exclusivo seguindo as instruções em Como oferecer um sistema de faturamento alternativo para usuários no Espaço Econômico Europeu (EEE) para faturamento alternativo.
- Integrar a Biblioteca Play Faturamento 6.2.1 ou uma versão mais recente.
Recomendamos que você tenha uma configuração de integração da API Google Play Developer pronta, porque ela será usada pela integração de back-end.
Como configurar no Play Console
Os desenvolvedores que concluíram a inscrição e estão integrados a APIs de faturamento alternativo podem gerenciar essas configurações no Play Console:
- Para cada um dos apps qualificados, ative ou desative a opção de oferecer apenas o faturamento alternativo (sem escolha do usuário) em cada país disponível
![](https://developer.android.com/static/images/google/play/billing/alternative/alt-bill-settings.png?authuser=9&hl=pt)
Tela de informações para usuários
A tela de informações ajuda os usuários a entender que apenas o sistema alternativo de faturamento está sendo oferecido no app qualificado. A tela de informações será mostrada aos usuários no início da primeira compra no app, depois que o faturamento alternativo for ativado. Essa mensagem não será mostrada nas próximas compras feitas pelo mesmo usuário no seu app no mesmo dispositivo. Observe que pode haver momentos em que a caixa de diálogo é mostrada de novo ao usuário em algumas situações, por exemplo, quando o usuário limpa os caches no dispositivo.
Próximas etapas
Para começar a integrar as APIs de faturamento alternativo, siga os guias detalhados da integração no app e da integração de back-end.