Como funciona o processo de retentativas em transferências Pix

Este artigo explica como funcionam as retentativas automáticas em transferências Pix, detalhando quando elas ocorrem, como podem ser configuradas e quais parâmetros da API permitem personalizar esse comportamento.
 
As retentativas automáticas são úteis para garantir a conclusão da transação mesmo quando há instabilidade no banco recebedor, ou seja, se você tentou realizar um pagamento e o banco está instável, a retentativa será acionada e aplicada em até 10 vezes, tetando fazer com que essa transação retorne sucesso. Por essa razão, em alguns casos, você pode visualizar o seguinte log via Internet Banking:



Cada banco pode ter tempos de resposta diferentes; o parâmetro rules permite ajustar a quantidade de retentativas conforme a necessidade.

Passo a passo do processo

1. Início da transferência Pix

   • O banco pagador (Stark Bank)envia a solicitação de transferência para o banco recebedor.

2. Resposta do banco recebedor

   • Se o banco recebedor responde com sucesso, a transação é concluída.

   • Se não houver resposta, o banco pagador (Stark Bank) inicia as retentativas automáticas.

3. Retentativas automáticas

   • Por padrão, são realizadas até 10 tentativas.

   • Cada tentativa ocorre em intervalos programados até que a transação seja confirmada ou o limite de tentativas seja atingido.

4. Configuração via parâmetro rules

   • A quantidade de retentativas pode ser ajustada na API usando o parâmetro rules.

   • Exemplo de configuração:

     "rules": {
       "retryAttempts": 5
     }
     

     Isso limita o número de retentativas a 5, por exemplo.

5. Finalização

   • Se o banco recebedor responder, a transação é concluída.

   • Se todas as tentativas falharem, a transação será marcada como falha e será retornada ao seu Internet Banking.