APIs de faturamento alternativo

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:

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:

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.

Recomendamos também 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.
A interface simulada, para fins ilustrativos, está sujeita a mudanças.

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:

  1. Ícone do app.
  2. Nome do app.
  3. Recurso de imagem que inclui formas de pagamento oferecidas pelo desenvolvedor.
  4. 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:

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 usar apenas o faturamento alternativo (ou seja, sem escolha do usuário) em cada país disponível
A interface simulada, para fins ilustrativos, está sujeita a mudanças.

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.