Retentativas

Após um pagamento ser recusado em uma fatura, o sistema de Pagamentos Recorrentes do PagBank oferece a opção de realizar novas tentativas de cobrança automaticamente. Esta facilidade visa proporcionar uma experiência mais flexível e conveniente para os usuários na gestão de transações financeiras.

📘

Métodos de pagamento aceitos

Retentativas de cobrança automática são configuráveis apenas para o método de pagamento cartão de crédito.

Configuração de Retentativas Automáticas

Atualmente, é possível configurar até 3 retentativas automáticas como padrão. A personalização dessas retentativas é realizada especificando os intervalos de cobrança em dias. Os intervalos permitidos são: 1, 3, 5 ou 7 dias. Ou seja, você escolhe o número de dias que o sistema deve esperar para realizar uma nova tentativa.

Você ainda pode definir a ação que será executado em caso de todas as retentativas falharem. Nesse caso você pode optar por suspender (SUSPEND) ou cancelar (CANCEL) a assinatura. Caso essa configuração não seja informada, por padrão o PagBank utilizará a opção cancelar (CANCEL).

📘

Ação manual

Você pode utilizar o endpoint Retentativa de Cobrança Manual para realizar uma nova tentativa de pagamento de forma manual.

Essa opção só está disponível se ainda existirem retentativas automáticas agendadas.

Exemplo de utilização

Suponha que ocorreu um contratempo ou erro na cobrança do seu cliente em 16/01, e você deseja configurar novas retentativas em intervalos de 3, 5 e 7 dias. A configuração seria a seguinte:

  • first_try = 3: A primeira tentativa ocorrerá em 19/01, três dias após a data da cobrança da fatura.
  • second_try = 5: A primeira tentativa ocorrerá em 24/01, cinco dias após a primeira retentativa de pagamento.
  • third_try= 7: A primeira tentativa ocorrerá em 31/01, sete dias após a segunda retentativa de pagamento.

Retentativas Manuais

A funcionalidade de Retentativa Manual de Cobrança permite realizar uma nova tentativa de cobrança de uma fatura vinculada a uma assinatura em atraso ou com status PENDING_ACTION. Essa opção estará disponível apenas se já houver uma retentativa automática agendada para a fatura em questão. Ao optar pela retentativa manual, a cobrança automática agendada será antecipada.

📘

Limite de tentativas

É permitido realizar apenas uma tentativa de cobrança manual por dia para cada assinatura.

Se o pagamento de uma assinatura for recusado, o status será alterado para PENDING_ACTION, e não haverá novas tentativas automáticas de cobrança. Para resolver essa situação, é preciso cadastrar um novo cartão válido. Ao adicionar o novo cartão, a cobrança automática não será realizada. Você deverá efetuar uma cobrança manualmente utilizando o endpoint Retentativa de Cobrança Manual , desde que ainda exista ao menos uma tentativa agendada.

Endpoints

A API de Pagamentos recorrentes do PagBank fornece os seguintes endpoints para que você configure as retentativas de pagamento automáticas:

  • Consultar Retentativas: Obtenha detalhes sobre as configurações de retentativas automáticas.
  • Alterar Retentativas: Modifique as configurações de retentativas automáticas para as suas assinaturas, ajustando os intervalos e as ações finais desejadas.
  • Retentativa de Cobrança Manual : Realize uma nova tentativa de cobrança manualmente de uma assinatura atrasada ou que tenha ações pendentes.