Configuração do Google Play

O Refund Sensor se conecta ao Google Play com uma conta de serviço que você cria no seu próprio projeto do Google Cloud. Ela nunca expira e não precisa ser reautorizada. Você vai precisar de:

• Um projeto do Google Cloud na conta dona do seu Play Console (um gratuito serve).
• Uma conta de serviço com uma chave JSON que você possa baixar.
• Acesso ao Play Console e o papel Pub/Sub Admin concedido a essa conta.
• Os nomes de pacote ou as URLs da Play Store que você quer defender.

1. Abra o Google Cloud Console com a conta dona do seu Play Console e selecione ou crie um projeto. No menu à esquerda, abra IAM & Admin e clique em Service accounts.
2. Clique em + Create service account, dê um nome como RefundSensor Google Play API e clique em Create and continue e Done. Você pode pular os papéis opcionais aqui.
3. Copie o e-mail da conta de serviço (termina em .iam.gserviceaccount.com). Você vai precisar dele nos próximos passos.
4. Abra a conta de serviço, vá para a aba Keys, clique em Add key → Create new key, escolha JSON e clique em Create. O Google baixa um arquivo .json. Guarde bem; o Google não deixa baixar de novo.

Seu projeto precisa de duas APIs do Google ativadas (um passo único por projeto). No Google Cloud Console, com seu projeto selecionado, procure e ative cada uma:

• Google Play Android Developer API, que permite à conta de serviço ler seus dados de reembolso e de pedidos.
• Cloud Pub/Sub API, que faz as notificações de reembolso em tempo real funcionarem. Confirme que é a Cloud Pub/Sub, não a Pub/Sub Lite, que é um produto diferente.

No Refund Sensor, abra Add app, escolha Google Play e envie o arquivo de chave .json. Verificamos com o Google e armazenamos criptografado em repouso com AES-256-GCM.

Convide a conta de serviço para o Play Console e dê acesso financeiro em dois lugares, já que os dados de reembolso (compras anuladas) são lidos no nível da conta:

1. No Google Play Console, abra Users and permissions → Invite new users e cole o e-mail da conta de serviço. Uma conta de serviço fica ativa assim que você salva; ela não aceita o convite por conta própria.
2. Em App permissions, adicione cada app que quer defender e ative View financial data e Manage orders and subscriptions.
3. Vá para a aba Account permissions (fácil de passar batido) e, em Financial data, ative View financial data, orders and cancellation survey responses e Manage orders and subscriptions, e salve.

As notificações em tempo real chegam ao Refund Sensor por um tópico do Pub/Sub que criamos e conectamos para você, então não há nada para colar no Play Console. Só é preciso permissão para gerenciar o Pub/Sub. Em IAM & Admin → IAM, clique em Grant access, cole o e-mail da sua conta de serviço como principal, selecione o papel Pub/Sub Admin (roles/pubsub.admin) e salve. Escolha Pub/Sub Admin, não Pub/Sub Lite Admin; o papel Lite não funciona e é o motivo mais comum de a configuração automática falhar.

No passo Add apps, cole uma URL da Play Store ou um nome de pacote por linha (o nome de pacote é o valor depois de ?id= em um link da Play Store, por exemplo com.yourcompany.app). O Refund Sensor valida cada um contra o acesso ao Play Console da conta conectada antes de importar, e sinaliza os que não consegue ver.

Com as APIs ativadas e o Pub/Sub Admin concedido, importar um app cria automaticamente o tópico e a assinatura push e o registra como endpoint de RTDN do app. O app então mostra Awaiting first refund event até o Google entregar o primeiro evento real (não existe botão de teste do lado do Google). Se a configuração automática falhar, o card do app mostra Real-time notifications not set up com um link de volta para este guia.

Não é possível contestar todo reembolso do Google Play. Um reembolso comum de usuário é decidido pelo Google por conta própria, então esses são registrados para visibilidade, mas não contestados.

O único reembolso ao qual você realmente pode responder é um chargeback em revisão (o pendingRefundReviewNotification do Google). Ele te dá cerca de 24 horas e considera a primeira resposta. O Refund Sensor responde automaticamente com uma recomendação de recusa, bem dentro da janela.

Como rede de proteção, o Refund Sensor também faz a reconciliação com a API de compras anuladas do Google, então todo reembolso e compra anulada aparece no seu painel mesmo quando não havia nada a contestar.