Regras de Retentativa

Disponível apenas em Sandbox

O Pix Automático está disponível somente no ambiente Sandbox. Não há suporte em produção no momento.

Quando uma cobrança é rejeitada, o arranjo do Pix Automático permite novas tentativas de liquidação, desde que o cliente tenha aceitado retentativas na autorização (is_retry_accepted igual a true). São até 3 novas tentativas por cobrança, em datas diferentes, solicitadas por você com o Retentar Cobrança.

Tentativas no mesmo dia

Tentativa	Janela de liquidação
1ª	Entre 00:00 e 08:00 do dia agendado.
2ª	Se não liquidou até 08:00, o banco do cliente tenta novamente entre 18:00 e 21:00 do mesmo dia.

Para entrar na janela do mesmo dia, o pedido de retentativa precisa ser enviado até 12:00 desse dia.

Tentativas em outros dias

Regra	Detalhe
Janela	Até 7 dias após a data original de liquidação. Para periodicidade semanal, até 5 dias.
Quantidade	Até 3 tentativas, em datas diferentes, dentro da janela.
Prazo de envio	Até 23:59 do dia anterior à nova data.
Horários	Cada nova data segue as mesmas janelas das tentativas no mesmo dia.
Fora da janela	Se não for possível retentar no prazo, o valor em atraso pode ser somado à cobrança do próximo ciclo, desde que respeite os limites aprovados pelo cliente.

Quais rejeições permitem retentativa

Código	Conta como tentativa	Permite retentativa no mesmo dia
reason_not_informed	Sim	Sim
refused_by_spi	Sim	Sim
spi_failure	Sim	Sim
icp_failure	Sim	Sim
receiving_institution_failure	Sim	Sim
insufficient_balance	Sim	Sim
amount_above_limit	Sim	Sim
refused_by_bank	Sim	Sim
bank_failure	Sim	Não
charge_amount_limit_exceeded	Sim	Não
invalid_retry_details	Não	Sim
invalid_amount	Não	Não
payment_authorization_mismatch	Não	Não
invalid_authorization	Não se aplica	Não
account_holder_mismatch	Não se aplica	Não
period_amount_limit_exceeded	Não se aplica	Não
period_quantity_limit_exceeded	Não se aplica	Não
total_amount_limit_exceeded	Não se aplica	Não
attempts_limit_exceeded	Não se aplica	Não
authorization_revoked	Não se aplica	Não
outside_allowed_period	Não se aplica	Não
insufficient_permission	Não se aplica	Não

Dica

Para rejeições que não contam como tentativa nem permitem retentativa (ex.: invalid_amount), corrija a causa e agende uma nova cobrança em vez de retentar.