​

Eventos de assinatura

Além dos webhooks de transação, a Pepper envia webhooks específicos para produtos do tipo assinatura. Na plataforma, ao configurar a integração de Webhooks, basta marcar Produto do tipo assinatura. Isso habilita o recebimento dos eventos abaixo.

​

Eventos disponíveis

Evento (event)	Nome na plataforma	Quando é enviado
subscription.created	Nova Assinatura	Sempre que uma assinatura é criada (incluindo trial).
subscription.payment_success	Pagamento Aprovado	Pagamento confirmado na primeira cobrança ou em uma renovação.
subscription.activated	Assinatura Ativada	Assinatura passa para status ativo após pagamento aprovado (criação ou renovação).
subscription.payment_failed	Falha no Pagamento	Falha na renovação, enquanto ainda há tentativas de cobrança.
subscription.canceled	Assinatura Cancelada	Cancelamento manual ou cancelamento automático após esgotar as tentativas de renovação.

​

Fluxo típico

​

Cartão / pagamento aprovado na hora

1. subscription.created
2. subscription.payment_success
3. subscription.activated

​

PIX / boleto (aguardando pagamento)

1. subscription.created
2. Depois do pagamento: subscription.payment_success + subscription.activated

​

Renovação com sucesso

1. subscription.payment_success
2. subscription.activated

​

Renovação com falha

1. subscription.payment_failed (enquanto houver retry)
2. subscription.canceled (quando a assinatura é encerrada por falha)

​

Payload

O campo event no JSON traz o nome do evento (ex.: subscription.created). A estrutura completa do payload v2.0 está em Subscription.