Integrações
Google Play
Service Account, Package Name e RTDN pra conectar seu app Android ao Paywallo.
O que você vai precisar
Pra conectar o Google Play ao Paywallo, você vai precisar de:
- Service Account JSON (credenciais de acesso à Google Play Developer API)
- Package Name (identificador do app Android)
- Pub/Sub Topic (pra notificações em tempo real)
Tudo é configurado no Google Cloud Console e no Google Play Console. Depois de juntar tudo, preenche no dashboard do Paywallo em Configurações, seção Android.
Criar a Service Account
A Service Account é o que permite o Paywallo acessar a Google Play Developer API pra validar compras e buscar informações de assinatura.
Acessa console.cloud.google.com e seleciona o projeto do seu app (se não tem, cria um)
No menu lateral, vai em IAM e administrador > Contas de serviço
Clica em Criar conta de serviço. Dá um nome (ex: paywallo-play) e clica em "Criar e continuar"
Na etapa de papel (role), não seleciona nenhum papel. Clica em "Concluir" — o acesso à AndroidPublisher API vem do convite no Play Console (próxima seção), não de papel de projeto no Cloud IAM.
Na lista de contas de serviço, clica na que você criou. Vai na aba Chaves > Adicionar chave > Criar nova chave > JSON
Baixa o arquivo .json e faz upload no dashboard do Paywallo na seção Android
Vincular ao Google Play Console
Depois de criar a Service Account, você precisa dar acesso a ela no Google Play Console:
No Google Play Console, vai em Usuários e permissões
Clica em Convidar novo usuário. No campo de email, cola o email da Service Account (formato nome@projeto.iam.gserviceaccount.com, tá no arquivo JSON que baixou)
Nas permissões, marca Ver dados financeiros, pedidos e respostas a pesquisas de cancelamento e Gerenciar pedidos e assinaturas. Salva.
Package Name
O Package Name é o identificador do app Android (ex: com.suaempresa.seuapp). Fica no Google Play Console, na página do app. Preenche no dashboard do Paywallo junto com a Service Account.
RTDN (notificações em tempo real)
Pra receber renovação, cancelamento e reembolso em tempo real, configure o Real-Time Developer Notifications via Google Cloud Pub/Sub:
No Google Cloud Console, vai em Pub/Sub > Tópicos > Criar tópico. Nome sugerido: paywallo-rtdn
No tópico criado, vai em Permissões > Adicionar principal. No email, digita: google-play-developer-notifications@system.gserviceaccount.com. No role, seleciona Pub/Sub Publisher
Ainda no tópico, vai em Assinaturas > Criar assinatura. Tipo de entrega: Push. Endpoint URL: copia a URL de webhook do dashboard do Paywallo (seção Android). Em seguida, marque Enable authentication, selecione a service account criada anteriormente, e defina Audience com a mesma URL do webhook (ex: https://paywallo.com.br/webhooks/google/SUA_APP_KEY). Salva a assinatura.
Enable authentication é obrigatório. Sem ele, o Pub/Sub envia os RTDNs sem o header Authorization: Bearer, o webhook do Paywallo rejeita silenciosamente e responde 200 {"success":false}. Renovações e cancelamentos nunca chegam ao dashboard.
No Google Play Console, vai em Monetizar > Configuração de monetização > Real-time developer notifications. Cola o nome completo do tópico: projects/SEU-PROJETO/topics/paywallo-rtdn. Salva.
Ainda no Play Console, na mesma tela de Real-time developer notifications, clica em Send test notification. Se tudo estiver correto, o Pub/Sub vai entregar a notificação no webhook e você verá 200 {"success":true} nos logs. Esse é o único jeito de confirmar que o RTDN está chegando de ponta a ponta.
No dashboard do Paywallo, clica em Testar conexão. Esse botão valida somente o acesso à AndroidPublisher API via service account — confirma que o JSON está correto, mas não testa o RTDN. Use o Send test notification do Play Console (passo anterior) pra validar o fluxo completo.
Essa página foi útil?
Desenvolvido e mantido por Virex