Geração de pagamentos com Múltiplas Adquirentes
Como funciona o fluxo de geração
Quando um sistema externo solicita a criação de um pagamento via API, o processo ocorre da seguinte forma:
A requisição chega ao gateway
O gateway processa internamente a validação (normalmente em poucos milissegundos)
O gateway chama a primeira adquirente da fila
Se a adquirente:
Retornar sucesso → o pagamento é gerado
Retornar falha → o gateway tenta a próxima adquirente
Demorar para responder → o gateway precisa aguardar o retorno
Esse processo continua até:
Uma adquirente gerar o PIX com sucesso
Ou todas as adquirentes falharem
Exemplo prático de tempo de execução
Supondo o seguinte cenário:
Sistema externo solicita o PIX no momento 0ms
O gateway leva 200ms para processar internamente
A primeira adquirente demora 7.000ms e retorna falha
A segunda adquirente demora 5.000ms e retorna sucesso
O gateway leva mais ~30ms para preparar a resposta
Tempo total: aproximadamente 12.230ms
Ou seja, mais de 12 segundos para geração do PIX.
Importante:
Esse tempo não representa lentidão do gateway, mas sim a soma do tempo de resposta das adquirentes consultadas.
Por que pode ocorrer erro de “timeout”?
Muitas plataformas que consomem a API configuram um limite máximo de espera, chamado de timeout.
Esse timeout define quanto tempo o sistema aguarda a resposta antes de considerar a requisição como falha.
Exemplo:
Se o sistema configurou timeout de 12.000ms e o PIX levou 12.230ms para ser gerado, o solicitante irá registrar como:
“timeout exceeded”
Mesmo que o PIX tenha sido gerado corretamente segundos depois.
O que causa o aumento do tempo total?
O tempo final de geração é impactado por:
Lentidão da primeira adquirente
Falha na primeira tentativa e necessidade de fallback
Tempo de resposta da segunda adquirente
Instabilidade momentânea nas APIs externas
O gateway apenas orquestra as chamadas.
Ele depende diretamente do tempo de resposta das adquirentes integradas.
Pontos importantes
O gateway não cancela uma adquirente antes do retorno
O fallback só acontece após resposta de falha
Se uma adquirente demora para responder, o sistema precisa aguardar
Quanto mais adquirentes na fila, maior pode ser o tempo total em caso de falha inicial
Como mitigar esse cenário
Algumas alternativas:
Ajustar o timeout da plataforma solicitante para um tempo maior
Reavaliar a ordem das adquirentes
Priorizar adquirentes com menor latência
Monitorar tempo médio de resposta por adquirente
Conclusão
A geração de PIX com múltiplas adquirentes funciona por tentativas sequenciais.
Se uma adquirente falha ou demora para responder, o tempo total de geração aumenta, pois o gateway precisa aguardar a resposta antes de tentar a próxima.
Erros como “timeout exceeded” normalmente estão relacionados ao limite configurado no sistema que solicitou o PIX, e não a uma falha estrutural do gateway.