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

# Status de assinatura

> Status que uma assinatura pode assumir nos webhooks

# Status de assinatura

O campo `subscription.status` no payload do webhook pode assumir os valores abaixo.

<table>
  <thead>
    <tr>
      <th>Valor</th>
      <th>Descrição</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`active`</td>
      <td>Assinatura ativa</td>
    </tr>

    <tr>
      <td>`waiting_payment`</td>
      <td>Aguardando pagamento</td>
    </tr>

    <tr>
      <td>`unpaid`</td>
      <td>Não paga (ex.: falha de renovação em retry)</td>
    </tr>

    <tr>
      <td>`canceled`</td>
      <td>Cancelada</td>
    </tr>

    <tr>
      <td>`trial`</td>
      <td>Em período de trial</td>
    </tr>

    <tr>
      <td>`ended`</td>
      <td>Finalizada (ex.: atingiu o número máximo de ciclos)</td>
    </tr>

    <tr>
      <td>`returned`</td>
      <td>Devolvida</td>
    </tr>
  </tbody>
</table>

> [!NOTE]
>
> Na configuração do webhook na plataforma, ao marcar **Produto do tipo assinatura**, os filtros de status habilitados por padrão são: `active`, `unpaid`, `canceled` e `waiting_payment`.


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