Multiadquirência

Multiadquirência é trabalhar com mais de uma adquirente ao mesmo tempo, em vez de depender de um provedor só. Na xFlow Payments, ela é online e para Pix: você integra uma API Pix e ela conecta a sua operação a 11 adquirentes homologadas. Regras de roteamento escolhem quem processa cada cobrança, e a retentativa automática passa a cobrança para a próxima adquirente quando uma não responde.

Multiadquirência no balcão e multiadquirência online

O termo nasceu no varejo físico e ainda é muito usado nesse sentido. Por isso vale separar os dois mundos:

A xFlow não vende maquininha nem TEF. Se a sua operação é online e recebe por Pix, a multiadquirência da xFlow é a que se aplica.

Como funciona a multiadquirência na xFlow

1. Você integra a API da xFlow uma vez, com chave pública e segredo.
2. Na configuração da sua conta, você define as regras de roteamento com a equipe da xFlow: qual adquirente recebe cada cobrança, por valor, horário e dia da semana.
3. Cada regra tem uma cadeia de contingência, com as adquirentes em ordem.
4. A cada POST /api/v1/charges, a xFlow aplica a regra e pede a cobrança à primeira adquirente.
5. Se ela não responde, a xFlow tenta de novo e, se precisar, gera a cobrança na próxima.
6. O pagamento é conferido na adquirente antes de cair no saldo, e o webhook transaction.paid avisa o seu sistema.

Os detalhes de cada etapa estão em roteamento de pagamentos e retentativa automática.

Exemplo: uma loja online com três adquirentes

Imagine uma loja que vende pelo site e recebe por Pix. Os nomes são genéricos:

• Durante a semana, as cobranças vão para a Adquirente A. Se ela não responde, a cobrança vai para a B e, depois, para a C.
• No fim de semana, a ordem muda: primeiro a B, depois a A.
• Cobranças acima de um valor definido pela loja seguem uma cadeia própria, começando pela C.

O código da loja é o mesmo nos três casos: uma chamada a POST /api/v1/charges. Quem aplica a regra e troca de adquirente é a xFlow. Se a loja quiser mudar a ordem, muda a regra, não o sistema.

Por que ter mais de uma adquirente

• Contingência. Uma adquirente fora do ar não para a geração de cobranças, porque a próxima da cadeia assume.
• Menos dependência. Mudanças de regra, de condição ou de limite em um provedor não travam a operação inteira.
• Faixas de valor. Dá para mandar o tíquete baixo para uma adquirente e o alto para outra.
• Horários e dias. Dá para usar adquirentes diferentes em horários ou dias diferentes.

O que dá trabalho sem uma camada de orquestração

Ter várias adquirentes integradas direto no seu sistema significa manter, para cada uma:

• uma integração, com autenticação e formato próprios;
• um endpoint de webhook e uma forma de validar as notificações;
• uma lógica de troca de adquirente quando ela falha;
• uma rotina de conciliação, porque cada uma devolve dados de um jeito;
• um cuidado próprio com cobrança duplicada nos retries.

Na xFlow, tudo isso fica atrás de uma API só. Você mantém uma integração, um formato de resposta e um webhook. A explicação completa está em orquestração de pagamentos.

Uma integração, várias adquirentes: o que a API entrega

Tudo com o mesmo formato de resposta, seja qual for a adquirente que processou a cobrança. A documentação tem os exemplos completos.

Limites que você precisa conhecer

• A multiadquirência da xFlow é para Pix. Cartão e checkout hospedado ainda não estão na API.
• O estorno é pedido à adquirente que gerou a cobrança. Se ela não oferece estorno pela API, a resposta é 422 refund_not_supported.
• O saque por QR Code funciona só em algumas adquirentes. Nas outras, a API responde 422 transfer_failed sem debitar nada.

Para quem faz sentido

A multiadquirência online interessa principalmente a quem tem volume e não pode parar: subadquirentes e operações white label, fintechs, marketplaces e e-commerce de alto volume. Se a sua dúvida é sobre o que muda quando o Pix passa por mais de um provedor, leia orquestração de Pix com vários PSPs.