Integrações

RevenueCat

Importe compras, renovações e reembolsos do RevenueCat pro Paywallo com um webhook — sem precisar trocar de provider de pagamento.

Configurar o webhook

Pré-requisito

Ative a integração no dashboard (Configurações → Integrações → RevenueCat) para gerar a URL do webhook e o secret.

1

No dashboard do Paywallo, acesse Configurações > Integrações > RevenueCat, clique em Ativar e copie a URL do webhook e o secret gerado.

2

No dashboard do RevenueCat, vá em Project Settings > Integrations > Webhooks e adicione um novo endpoint com a URL no formato https://paywallo.com.br/api/webhook/revenuecat/{sua-chave-app}.

3

Ainda na tela de webhook do RevenueCat, preencha o campo de autorização:

Campo (RevenueCat)Valor
Authorization headerBearer {seu-secret}

Substitua {seu-secret} pelo secret copiado do Paywallo. O prefixo Bearer é obrigatório. Requisições sem o header correto são rejeitadas com 401.

4

Salva o webhook no RevenueCat. Os eventos vão começar a aparecer no Paywallo em tempo real.

Eventos obrigatórios

Marque todos esses eventos no RevenueCat ao configurar o webhook. Eles são necessários pra atribuição, analytics e reembolsos funcionarem corretamente.

INITIAL_PURCHASE
RENEWAL
NON_RENEWING_PURCHASE
CANCELLATION
UNCANCELLATION
EXPIRATION
BILLING_ISSUE
PRODUCT_CHANGE

O que é importado

Cada categoria de evento é processada de forma diferente pelo Paywallo:

ComprasINITIAL_PURCHASE · NON_RENEWING_PURCHASE

Cria uma transação no Paywallo e dispara CAPI para as plataformas de anúncio conectadas (Meta e TikTok).

RenovaçõesRENEWAL

Registra a renovação da assinatura como uma nova transação.

ReembolsosCANCELLATION (com cancel_reason)

Detecta cancelamentos por reembolso e os marca na transação original.

Ciclo de vidaCANCELLATION · EXPIRATION · BILLING_ISSUE · PRODUCT_CHANGE · UNCANCELLATION

Gera eventos de lifecycle ($subscription_cancelled, $subscription_expired, etc.) para analytics.

Essa página foi útil?

Desenvolvido e mantido por Virex