Paywallo

Integrações

Apple App Store

Credenciais, API Key e webhooks pra conectar seu app iOS ao Paywallo.

O que você vai precisar

Pra conectar a App Store ao Paywallo, você vai precisar de:

  • Bundle ID (identificador do app)
  • Key ID (ID da chave de API)
  • Issuer ID (identificador do emissor)
  • Chave privada (.p8)

Abaixo tá o guia de onde buscar cada um. Tudo fica no App Store Connect. Depois de juntar tudo, preenche no dashboard do Paywallo em Configurações, seção iOS.

Bundle ID

No App Store Connect, abre o app e vai em Distribuição > Informações do app. Na seção "Informações gerais", o ID do pacote é o Bundle ID.

Key ID, Issuer ID e chave .p8

No App Store Connect, vai em Usuários e acesso > Integrações > API do App Store Connect.

1

Clica em Gerar chave de API (ou "Generate API Key")

2

Escolhe o role Administrador ou Gerente de apps

3

O Key ID aparece na coluna "ID DA CHAVE" e o Issuer ID fica no topo da página

4

Clica em "Download" ao lado da chave pra baixar o arquivo .p8. A Apple só permite baixar uma vez. Faz upload no dashboard do Paywallo.

Webhooks (Server Notifications V2)

Pra receber renovação, cancelamento e reembolso em tempo real, configura os webhooks:

1

No dashboard do Paywallo, copia a URL de webhook da seção iOS

2

No App Store Connect, abre o app, vai em Informações do app, desce até Notificações do servidor da App Store

3

Cola a URL nos campos URL do servidor de produção e URL do servidor do sandbox (mesma URL nos dois).

4

Em Versão da notificação, selecione Version 2. O Paywallo processa apenas notificações V2 (campo signedPayload) — se ficar em V1/legado, os eventos de renovação, cancelamento e reembolso são descartados em silêncio e a tabela de assinaturas não popula.

Atenção: o botão "Testar conexão" no App Store Connect valida apenas a conectividade de rede com a URL, não a entrega das notificações. A Apple não possui opção de enviar um evento de teste por app. Para confirmar que os webhooks estão chegando, acompanhe os eventos na seção de logs do dashboard do Paywallo após uma transação real ou de sandbox.

Essa página foi útil?

Desenvolvido e mantido por Virex