Roteamento de Saques entre Adquirentes
⚙️ Como funciona na prática
O produtor solicita um saque
O sistema verifica a primeira adquirente da fila
Se essa adquirente não possui saldo suficiente para concluir o saque, o sistema tenta completar o valor utilizando a próxima adquirente da fila
Para isso, a adquirente precisa permitir ou possuir a função de consulta de saldo
Se não houver saldo suficiente, ou se a adquirente não permitir a consulta de saldo, o sistema tenta a próxima adquirente
O processo se repete até:
Encontrar saldo suficiente
Ou não haver mais adquirentes disponíveis
⚠️ Quando o roteamento não pode continuar
Existe um cenário crítico onde o sistema não pode avançar para a próxima adquirente:
Quando o saque é criado em uma adquirente e retorna com status PENDENTE.
Nesse caso, o gateway considera que aquela adquirente já está processando a solicitação e, por segurança, não pode iniciar um novo saque em outra adquirente para complementar o valor.
Isso evita:
Saque duplicado
Inconsistência de saldo
Divergência financeira entre adquirentes
Risco de pagamento em duplicidade
O que isso pode implicar na prática
Se uma adquirente, por qualquer motivo, sempre retornar o saque como PENDENTE, o roteamento ficará travado nela.
Ou seja:
O sistema não poderá tentar a próxima adquirente
O valor ficará aguardando definição naquela primeira adquirente
Agora vem o ponto mais sensível:
Se posteriormente essa adquirente notificar via webhook que o saque falhou, o gateway não consegue retomar automaticamente o roteamento para outra adquirente.
Isso ocorre porque:
A tentativa original já foi iniciada
O fluxo de roteamento foi encerrado naquele ponto
Não existe reprocessamento automático após falha tardia
Consequência operacional
Nesses casos, pode ser necessário:
Criar uma nova solicitação de saque
Ou realizar intervenção manual
Por isso, a confiabilidade e o comportamento da adquirente na atualização de status impactam diretamente o funcionamento do roteamento.
🔎 Como visualizar os detalhes de um saque
Na lista de saques do painel, é possível visualizar informações detalhadas de cada solicitação.
Como acessar:
Acesse a lista de saques
Localize o saque desejado
Clique no ícone de olho (visualizar)
Ao clicar, será aberto um modal com os detalhes completos do saque.
Informações exibidas no modal
Na aba Informações Gerais, é possível visualizar:
Dados do produtor
Banco e chave PIX
Valor solicitado
Taxa aplicada
Valor líquido a receber
Status atual
Indicadores de risco (quando aplicável)
Envios via API (quando houver múltiplas adquirentes)
Se o saque tiver sido processado utilizando uma ou mais adquirentes via API, o modal exibirá uma aba adicional chamada:
“Histórico de envios” ou “Envios via API”
Nessa aba é possível visualizar:
Valor enviado por cada adquirente
Nome da adquirente utilizada
Data e hora de envio
Status atualizado
Identificador da operação na adquirente
Quando o saque é dividido entre adquirentes, cada envio aparece individualmente no histórico, permitindo rastreabilidade completa da operação.
📌 Conclusão
O roteamento de saque permite maximizar a chance de pagamento utilizando múltiplas adquirentes.
Além disso, a plataforma oferece transparência total ao administrador e ao produtor, permitindo visualizar:
Como o saque foi dividido
Por quais adquirentes foi enviado
Qual o status de cada envio
Isso garante controle operacional, rastreabilidade e segurança financeira em toda a operação.