Provedores e roteamento

No gateway white label da XF TECH, você não fica preso a um único parceiro financeiro. A sua operação cadastra os provedores que processam os pagamentos, configura as credenciais de cada um e monta fluxos que decidem para onde vai cada cobrança. Quando um provedor falha, o fluxo segue para o próximo da cadeia. Tudo isso é configurado no painel administrativo, sem desenvolvimento.

Por que ter mais de um provedor

Uma operação com um único parceiro financeiro fica exposta a qualquer instabilidade dele. Com mais de um provedor cadastrado, você pode:

• seguir gerando cobranças quando um provedor falha, pelo fallback;
• separar faixas de valor ou horários entre provedores com condições diferentes;
• testar um provedor novo com parte do volume antes de aumentar;
• negociar com mais de um parceiro, porque a troca não exige desenvolvimento.

Cadastro de provedores

Cada provedor é cadastrado com:

• as credenciais de acesso, guardadas cifradas no banco de dados;
• os métodos que ele atende;
• se ele processa entrada (cobranças), saída (saques) ou as duas;
• credenciais separadas para saída, quando o provedor exige;
• os custos por método, em percentual e valor fixo, e o custo do saque.

Com os custos cadastrados, a operação enxerga quanto paga a cada provedor e quanto sobra da taxa cobrada do lojista.

Importante: cada provedor depende de integração, contrato, credenciais e homologação. A plataforma já tem integrações com provedores Pix; um provedor que ainda não foi integrado precisa de desenvolvimento antes de entrar na operação.

Fluxos de roteamento

O roteamento das cobranças é montado num editor visual, em blocos ligados entre si:

• início, onde a cobrança entra;
• provedor, que tenta gerar a cobrança;
• condição, que escolhe o caminho;
• divisão, que reparte o volume entre caminhos por peso;
• fim.

Condições disponíveis

Tentativas e tempo limite

Em cada bloco de provedor você define o tempo limite, o número de tentativas e o intervalo entre elas. Se o provedor não responder, o fluxo segue para o próximo caminho.

Divisão de volume

O bloco de divisão escolhe um caminho por peso e deixa os outros como contingência. Assim, você pode mandar uma parte do volume para um provedor novo e acompanhar o resultado antes de aumentar, sem perder o fallback.

Fluxo padrão e fluxo por lojista

Um fluxo pode ser o padrão da operação ou ser atribuído a um lojista específico, no cadastro dele. Cada fluxo pode ser ativado ou desativado.

Fallback

A tela de fallback mostra a ordem real de contingência da entrada, derivada do fluxo padrão: em que ordem os provedores são tentados quando o anterior falha. Na saída, os saques usam o provedor atribuído ao lojista ou o provedor padrão da operação.

Acompanhamento

Logs, webhooks, filas, conciliação, incidentes e alertas ficam na área operacional do painel administrativo. Com essa visão, a sua equipe acompanha o que entrou, o que falhou e decide quando mudar a ordem ou o peso de cada provedor.

Teste de fluxo

Antes de colocar um provedor em produção, a bancada de teste gera um Pix, faz um saque de valor pequeno ou consulta o saldo direto na credencial do provedor, e mostra o que ele devolveu no webhook. Assim você confirma que a integração e as credenciais estão certas.

Onde isso entra na operação

O parceiro financeiro processa a cobrança e liquida; a XF TECH orquestra o roteamento e registra tudo no ledger. A página como funciona mostra o fluxo completo. Se você ainda está escolhendo o parceiro financeiro, veja a etapa correspondente no guia como abrir um gateway de pagamento.