xFlow para subadquirentes

Uma subadquirente processa pagamentos em nome de muitos clientes ao mesmo tempo. Quando o provedor Pix para, todos esses clientes param junto. A xFlow Payments resolve isso com uma camada de orquestração de pagamentos: uma API ligada a 11 adquirentes homologadas, com roteamento por regras e retentativa automática, além de saque Pix por API para os repasses.

As dores de quem opera uma subadquirente

• Depender de um provedor só. Uma queda vira indisponibilidade para toda a sua base de clientes.
• Manter várias integrações. Cada adquirente nova é mais uma API, mais um webhook e mais uma rotina de conciliação.
• Repassar com segurança. Pagar os clientes exige saque por API sem risco de pagamento em dobro.
• Rastrear cada cobrança. Com muito volume, achar a cobrança de um cliente específico precisa ser rápido.
• Responder ao suporte. Quando um cliente reclama, você precisa ver o que aconteceu em cada chamada.

Recursos da xFlow que resolvem

Fluxo de exemplo: da venda do seu cliente ao repasse

1. Um comprador fecha um pedido na loja de um cliente seu. A sua plataforma chama POST /api/v1/charges com o valor e um external_reference como loja-123:pedido-987.
2. A regra de roteamento da sua conta escolhe a adquirente. Se ela não responde, a xFlow passa para a próxima da cadeia.
3. A API devolve o QR Code e o copia e cola. Você mostra ao comprador.
4. O comprador paga. A xFlow confere o pagamento na adquirente e envia o webhook transaction.paid, com o valor, o líquido (net) e a taxa (fee).
5. A sua plataforma credita o cliente no seu controle interno, usando o external_reference.
6. No momento do repasse, você chama POST /api/v1/transfers com a chave Pix do cliente e um Idempotency-Key único para aquele repasse.
7. Os webhooks withdrawal.processing, withdrawal.completed ou withdrawal.failed informam o resultado.

curl -X POST https://app.xflowpayments.com/api/v1/transfers \
  -u "pk_live_...:sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: repasse-loja-123-0001" \
  -d '{"amount": 48000, "pix_key": "12345678000190", "pix_key_type": "CNPJ"}'

Se o seu sistema repetir o pedido com o mesmo Idempotency-Key, a API devolve o mesmo saque em vez de debitar o saldo de novo. Os detalhes estão em API de saque Pix.

Como começar

1. Crie a conta da sua operação na xFlow.
2. Gere uma chave de teste em Desenvolvedores > Chaves de API. Ela pode ser criada antes da aprovação do cadastro.
3. Integre a criação de cobranças e o webhook no ambiente de teste, simulando pagamentos com POST /api/v1/test/charges/{id}/pay.
4. Com o cadastro aprovado, defina com a equipe da xFlow as regras de roteamento e a cadeia de contingência da sua conta.
5. Troque para a chave de produção e ative os repasses por saque Pix, que não rodam no ambiente de teste.

Controles que importam para quem tem muitos clientes

• Allowlist de IP. Você pode limitar as chamadas aos IPs dos seus servidores. Fora da lista, a API responde 401, mesmo com a credencial correta.
• Saque automático. Com o saque automático desligado, cada saque nasce pendente de aprovação (pending_approval: true).
• Revogação imediata. Uma credencial comprometida é revogada no painel e para de funcionar na hora.
• Webhooks assinados. Cada envio traz x-webhook-signature, um HMAC-SHA256 do corpo, para você confirmar que veio da xFlow.

Mais detalhes em segurança.

Para operações white label

Se você opera com marca própria, a sua plataforma conversa com a API da xFlow, e a xFlow cuida da camada Pix: roteamento, contingência entre adquirentes, confirmação dos pagamentos e saques. A tecnologia por trás da xFlow Payments é da XF TECH, como explicado na página sobre a xFlow.