> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pepper.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Eventos de assinatura

> Webhooks disparados no ciclo de vida de uma assinatura

# 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.

> [!NOTE]
>
> Os webhooks de assinatura são independentes dos de transação. Você pode configurar só assinatura, só transação, ou ambos na mesma integração.

## Eventos disponíveis

<table>
  <thead>
    <tr>
      <th>Evento (`event`)</th>
      <th>Nome na plataforma</th>
      <th>Quando é enviado</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`subscription.created`</td>
      <td>Nova Assinatura</td>
      <td>Sempre que uma assinatura é criada (incluindo trial).</td>
    </tr>

    <tr>
      <td>`subscription.payment_success`</td>
      <td>Pagamento Aprovado</td>
      <td>Pagamento confirmado na primeira cobrança ou em uma renovação.</td>
    </tr>

    <tr>
      <td>`subscription.activated`</td>
      <td>Assinatura Ativada</td>
      <td>Assinatura passa para status ativo após pagamento aprovado (criação ou renovação).</td>
    </tr>

    <tr>
      <td>`subscription.payment_failed`</td>
      <td>Falha no Pagamento</td>
      <td>Falha na renovação, enquanto ainda há tentativas de cobrança.</td>
    </tr>

    <tr>
      <td>`subscription.canceled`</td>
      <td>Assinatura Cancelada</td>
      <td>Cancelamento manual ou cancelamento automático após esgotar as tentativas de renovação.</td>
    </tr>
  </tbody>
</table>

## 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](/webhooks/v2/subscription).

> [!NOTE]
>
> Nos webhooks de assinatura (v2.0), valores como `subscription.price`, `offer.price` e `transaction.amount` são enviados como **string em reais** (ex.: `"9.99"`), e não em centavos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.