Este post é baseado nas informações publicadas na documentação oficial que pode ser encontrada no VTEX Helper.
O pedido com boleto envolve o cancelamento de três itens, que podem gerar dúvidas. Por isso, antes vamos separar essas três definições para seguirmos com os prazos de cada uma delas.
Prazo de validade do boleto
A validade do boleto é o prazo para o boleto não ser mais aceito para realizar o pagamento. Para algumas afiliações de gateway, este prazo pode ser configurado na aba de Pagamentos no Admin, conforme imagem abaixo.
Prazo para cancelamento de boleto registrado
Existem dois tipos de boletos: aqueles cujo status de pagamento a VTEX consegue verificar por meio de uma URL e aqueles em que essa verificação não é realizada.
Essa diferença acontece por conta do posicionamento de cada banco. Existem algumas instituições financeiras que cedem à VTEX o endpoint necessário para essa verificação, enquanto outras ainda não implementaram esse tipo de solução.
Desse modo, para esses bancos o cancelamento é feito da seguinte forma: existe uma janela de tempo entre o momento em que o cliente finaliza a compra e o momento em que, de fato, paga o boleto. Durante esse período, a VTEX realiza múltiplas chamadas de verificação junto ao banco. Esse processo dura, em média, sete dias corridos.
Se o cliente não realizar o pagamento durante esse período, o boleto é cancelado.
Cabe ressaltar que o número de tentativas é calculado com base no valor enviado pelo gateway de pagamentos no campo delayToCancel na resposta da requisição da transação, conforme a documentação Create Payment. Ou seja, esse campo não pode ser alterado pelo cliente ou diretamente na plataforma VTEX, é um campo que precisa ser ajustado pelo conector de pagamentos, caso seja necessário.
O valor enviado no campo é dividido por 86.400 (segundos em um dia), se o resultado for maior que 0 significa que o delayToCancel é maior que um dia. Se for esse o caso, a quantidade de novas tentativas será igual a 6 tentativas por dia.
Se o resultado da divisão for igual a 0, significa que o delayToCancel tem um tempo menor ou igual a 1 dia para ser cancelado, sendo assim nesse caso, será feita 1 nova tentativa por hora.
Ou seja, se o campo delayToCancel for maior que 24 horas (86.400 segundos), serão feitas 6 tentativas por dia. Se for menor, será feita uma por hora.
Caso esse campo seja enviado como null, serão feitas 336 tentativas para aprovação desse tipo de pagamento.
Prazo para cancelamento da reserva dos produtos
Mesmo que o pedido continue como pagamento pendente, a reserva dos produtos comprados é liberada, para que esse fluxo não influencie a operação da loja. Para isso, o prazo para a liberação da reserva é calculado da seguinte forma:
O prazo de vencimento da reserva do estoque é o prazo de expiração do boleto + quatro, cinco ou seis dias corridos, seguindo as regras abaixo:
- Quatro dias para quando a data de expiração do boleto for domingo, segunda ou terça;
- Cinco dias para quando a data de expiração do boleto for quarta, quinta ou sexta;
- Seis dias para quando a data de expiração do boleto for sábado.
Para mais informações sobre como funciona a reserva, clique aqui.
Prazo para cancelamento do pedido
O cancelamento do pedido é realizado 20 dias após o prazo acima, ou seja, 20 dias + prazo de cancelamento da reserva. Tomando como exemplo a imagem acima, o pedido feito em uma quinta-feira e não pago seria cancelado 30 dias após a data de finalização: Prazo de cancelamento do boleto = 5 dias. Prazo de expiração da reserva = 5 + 5 = 10 dias. Prazo para cancelamento do pedido = 20 + 10 = 30 dias. Esse tempo, de aproximadamente um mês, permite que a compra seja recuperada junto ao cliente e se utilize o mesmo pedido para finalizar este processo caso o mesmo deseje.