# Eventos de Assinatura (Webhooks)

Uma assinatura é um modelo de pagamento recorrente, no qual o usuário realiza pagamentos periódicos para manter o acesso a um produto ou serviço.

Neste artigo, você entenderá como funcionam os eventos relacionados às assinaturas e como utilizá-los para acompanhar mudanças no status dos pagamentos.

A cada evento disparado, um e-mail informativo é enviado automaticamente ao usuário.

### Eventos disponíveis

Os eventos de assinatura são notificações automáticas disparadas pela plataforma sempre que ocorre alguma mudança no status de uma assinatura, como criação, pagamento, falha ou cancelamento.

Esses eventos são utilizados principalmente em integrações via [webhook](https://ajuda.ensinio.com/vendas/webhooks), permitindo que outros sistemas recebam essas informações em tempo real e executem ações automáticas, como liberar acessos, enviar comunicações ou atualizar registros.

A seguir, veja os eventos de assinatura disponíveis e o que cada um representa:

* **Assinatura criada**                                                                                                                                                      Disparado no momento em que o usuário contrata o plano.

* **Em processo de renovação**                                                                                                                                               Disparado quando a renovação é iniciada. Ocorre apenas para Boleto/Pix, em V−6 dias, quando o sistema gera a nova cobrança. Para cartão de crédito, este evento não existe.

* **Assinatura renovada**                                                                                                                                                         Disparado quando o pagamento do novo ciclo é confirmado. Pode ocorrer a qualquer momento, para ambos os métodos de pagamento.

* **Assinatura pendente**                                                                                                                                                        Disparado em V+2 dias quando o pagamento ainda não foi confirmado.

* **Assinatura não paga**                                                                                                                                                         Disparado quando a cobrança falha.  Após entrar em status de **não paga**, a plataforma realiza novas tentativas de cobrança antes do cancelamento automático.                                                                                                                                  Os disparos variam por método de pagamento:

  * Boleto/Pix: V+4, V+7 e V+8.
  * Cartão de crédito: V+5, V+10, V+15 e V+20.

  Caso o pagamento seja aprovado em qualquer uma dessas tentativas, o evento de **assinatura renovada** será disparado normalmente.

* **Assinatura cancelada**                                                                                                                                                   Disparado quando a assinatura é encerrada automaticamente por falta de pagamento:

  * Boleto/Pix: V+9.
  * Cartão de crédito: V+25.

* **Solicitação de cancelamento**                                                                                                                     Disparado quando o usuário solicita manualmente o cancelamento. Pode ocorrer a qualquer momento. A assinatura permanece ativa até o fim do período já pago.

{% hint style="info" %}
Saiba que:

* V = data de vencimento da cobrança. 
* V−X = dias antes do vencimento. 
* V+X = dias após o vencimento.
  {% endhint %}

Aqui vai uma tabela de resumo:

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FPhCCW7zn2gCcg6l8EWh1%2Fimage.png?alt=media&#x26;token=b3259a40-e344-43c2-818b-6b487cc02c69" alt=""><figcaption></figcaption></figure>

### Fluxos: Método de pagamento cartão de crédito

#### Fluxo 1 - sucesso

O sistema tenta cobrar o cartão na data de vencimento. O pagamento é aprovado imediatamente, a assinatura é marcada como renovada e o acesso do usuário é mantido. O ciclo reinicia normalmente para o próximo período.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2Fw2CtpPiBfw3GpyqnsKwb%2Fimage.png?alt=media&#x26;token=0dbe4daa-7a94-450a-aba0-d74512725635" alt=""><figcaption></figcaption></figure>

#### Fluxo 2 - falha e cancelamento automático

O sistema tenta cobrar o cartão na data de vencimento, mas a cobrança falha. Em V+2 a assinatura entra em pendente. Novas tentativas são feitas em V+5, V+10, V+15 e V+20. Se nenhuma for aprovada, a assinatura é cancelada automaticamente em V+25. Se o usuário regularizar o pagamento em qualquer ponto antes de V+25, a assinatura é renovada e o ciclo reinicia.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FLuz1RAANazI1TrZSqt7W%2Fimage.png?alt=media&#x26;token=b5d7a623-be35-44f6-9c10-1026f907306c" alt=""><figcaption></figcaption></figure>

#### Fluxo 3 - cancelamento manual

O usuário solicita o cancelamento a qualquer momento. A assinatura permanece ativa até o fim do período já pago e não gera novas cobranças.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FQpEMSkqIba0SlgkVxe9U%2Fimage.png?alt=media&#x26;token=9c925209-66e9-4df3-852d-557d3f71426c" alt=""><figcaption></figcaption></figure>

### Fluxos: Método de pagamento boleto e pix

#### Fluxo 4 — Boleto/Pix: sucesso

Em V−6 dias, o sistema gera o boleto ou a chave Pix para o próximo ciclo. O usuário realiza o pagamento antes do vencimento ou na data prevista. A assinatura é renovada e o ciclo reinicia normalmente.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2F3Bc3XGu2VrLCSt3Ziqlp%2Fimage.png?alt=media&#x26;token=05ba7e43-536f-46b6-b3d3-850a3672bf11" alt=""><figcaption></figcaption></figure>

#### Fluxo 5 — Boleto/Pix: falha e cancelamento automático

O boleto ou Pix é gerado em V-6. O usuário não paga até o vencimento. Em V+2 a assinatura entra em pendente. Novas notificações de não paga são disparadas em V+4, V+7 e V+8. Se nada for regularizado, a assinatura é cancelada automaticamente em V+9 — janela bem menor do que no cartão. Se o usuário pagar antes de V+9, a assinatura é renovada normalmente.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2Fg5Duk9icFVdMKOM5hQ1G%2Fimage.png?alt=media&#x26;token=9c82c709-6752-4020-8a1b-8c5727fc0844" alt=""><figcaption></figcaption></figure>

#### Fluxo 6 — Boleto/Pix: cancelamento manual

Igual ao cartão - o usuário solicita o cancelamento a qualquer momento, a assinatura permanece ativa até o fim do ciclo pago e não gera novas cobranças.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2Fa312ack90reRAhvt8mqN%2Fimage.png?alt=media&#x26;token=74634cf5-1595-4734-a931-5c541417c54c" alt=""><figcaption></figcaption></figure>