Preferências de notificação

Ao utilizar os recursos de Pagamento Recorrente do PagBank, você irá receber notificações relatando o avanço das operações. Essas notificações podem ser personalizadas conforme a sua necessidade. As configurações modificáveis incluem o envio de e-mails ao vendedor, o envio de e-mails ao assinante e a URL de notificação.

Endpoints

Para a configuração das notificações, o PagBank disponibiliza os seguintes endpoints:

Consultar Preferências de Notificações: Obtenha detalhes sobre as configurações atuais de notificações para uma assinatura específica.
Alterar Preferências de Notificações: Modifique as configurações de notificações para uma assinatura, ajustando as preferências de e-mails e a URL de notificação.

Notificações de email

As notificações enviadas por e-mail são acionadas devido a diversas regras de disparo. Na tabela abaixo você encontra essas regras segundo a situação atual da assinatura do pagamento recorrente.

Situação da assinatura	Regras
ASSINATURA ATIVA	Enviado quando uma nova assinatura é criada, e seu primeiro pagamento é confirmado. Nesse caso, o status da assinatura é atualizado para ativo. Este e-mail é exclusivo para o primeiro ciclo de assinaturas, seja por cartão ou boleto. Em meses subsequentes, outros e-mails são enviados conforme o status. No caso de assinaturas com cartão ou boleto que possuem período de trial, o disparo desse e-mail é realizado mesmo que a fatura esteja zerada.
ASSINATURA CANCELADA	Enviado quando o estabelecimento cancela a assinatura por motivos diversos, incluindo relacionamento, não pagamento ou outros problemas. Também é enviado se o pagamento for negado após todas as retentativas configuradas. Esse segundo caso depende da configuração do cancelamento no final do fluxo.
ASSINATURA SUSPENSA	Enviado quando o estabelecimento suspende a assinatura, em casos de não pagamento após 7 dias ou quando o pagamento é negado após todas as retentativas (configuração padrão).
ASSINATURA ATRASADA	Enviado quando o pagamento da assinatura está em atraso ou quando há uma tentativa de cobrança (via cartão) sem sucesso. O status muda para atrasada no exato momento em que o pagamento é negado.
BOLETO GERADO	Enviado quando uma assinatura com boleto é criada, sete dias antes do vencimento de cada ciclo.
BOLETO PAGO COM SUCESSO	Enviado quando o pagamento de uma assinatura com boleto é compensado pela instituição financeira. Não é enviado no primeiro ciclo; nesse período, o e-mail de "Assinatura Ativa" é disparado.
ASSINATURA REATIVADA	Enviado quando o estabelecimento reativa uma assinatura que estava suspensa. Não é possível reativar assinaturas com status ativo, atrasado, cancelado, expirado, em período de trial ou pendente.
PAGAMENTO ESTORNADO	Enviado quando o estabelecimento solicita e o estorno de pagamento é realizado com sucesso.