Ir para o conteúdo
Refund Sensor

Configuração da App Store da Apple

Configure o Refund Sensor para a App Store da Apple. Gere uma chave de API do App Store Connect, conecte-a e adicione sua URL de webhook. Cerca de 5 minutos do início ao fim.

Antes de começar

Você vai precisar do seguinte, e leva cerca de 5 minutos:

  • Acesso de Admin ou Account Holder no App Store Connect.
  • Uma chave de API do App Store Connect, que te dá três valores: um Issuer ID, um Key ID e um arquivo de chave privada .p8.

Nenhum arquivo é enviado para a Apple e nenhuma alteração é feita no binário do seu app.

Crie sua chave de API

O Issuer ID, o Key ID e o arquivo .p8 vêm todos do mesmo lugar no App Store Connect:

  1. Entre no App Store Connect, abra Users and Access, selecione a aba Integrations e escolha In-App Purchase na seção Keys, à esquerda.
  2. Copie o Issuer ID exibido no topo da página. É um único valor válido para toda a conta, compartilhado por todas as chaves que você gerar.
  3. Clique no botão + ao lado de Active para gerar uma nova chave. Dê o nome Refund Sensor, defina Access como Admin e clique em Generate.
  4. Copie o Key ID da nova chave e clique na linha dela para fazer Download do arquivo .p8. A Apple só deixa você baixar uma vez, então guarde em lugar seguro.

Adicione suas credenciais

No Refund Sensor, abra Add app e escolha Apple App Store. Cole seu Issuer ID e seu Key ID, envie o arquivo .p8 e clique em Continue. Verificamos a chave com a Apple e a criptografamos em repouso com AES-256-GCM antes de armazenar. Ela nunca é exibida de novo nem aparece em logs.

Escolha seus apps

Depois que a chave é verificada, o Refund Sensor busca todos os apps que consegue ver na sua conta do App Store Connect. Pesquise por nome ou bundle ID, selecione os apps que quer defender e clique em Connect. Cada app conectado recebe a própria URL de webhook.

Adicione a URL de webhook no App Store Connect

Este é o último passo, feito uma vez por app depois de conectá-lo. A Apple envia as notificações de servidor para uma única URL:

  1. Copie a URL de webhook do app no Refund Sensor (aparece no card do app conectado).
  2. No App Store Connect, abra a página App Information desse app e desça até App Store Server Notifications.
  3. Clique em Set Up URL para a Production Server URL, cole a URL e salve. Depois faça o mesmo na Sandbox Server URL, para que o tráfego de teste e o real cheguem ao Refund Sensor.

Cada app conectado tem a própria URL exclusiva, gerada por nós e mostrada no card dele no Refund Sensor. Copie de lá em vez de digitar à mão.

Já usa RevenueCat, Adapty ou Apphud?

A Apple permite apenas uma URL de notificações de servidor e, se uma plataforma de assinaturas já usa essa URL, não substitua. Em vez disso, peça para essa plataforma reenviar uma cópia de cada notificação bruta da Apple para a sua URL de webhook do Refund Sensor, assim as duas continuam funcionando. Veja Reenvio de notificações para os passos exatos de RevenueCat, Adapty e Apphud.

Verifique a conexão

O Refund Sensor confirma que consegue receber as notificações da Apple antes de começar a agir em eventos reais. Até a conexão ser verificada, os eventos ao vivo são registrados mas não recebem ação, então uma configuração pela metade nunca envia uma resposta por engano.

On this page