Flow determinístico e publicável
Um AcquirerFlow por método de pagamento decide o provider por condição (bandeira, valor, parcela), com snapshot de flow/step gravado na charge. Sem caixa-preta.
Orquestração
Várias adquirências, um só fluxo.
Você desenha o Payment Flow — por método, bandeira, valor e parcela — e a Bunne roteia a transação entre Cielo, Rede, Stone, Pagar.me e Braspag. A adquirência é um driver substituível; o core financeiro é seu.
Payment Flow · Cartão
Visa · à vista · live
Valor
R$ 1.280,00
Flow publicado · v3
Ordem por prioridade + condições (bandeira, valor, parcela)
1Cielorecusa limpa
2Redeautorizado
Ambíguo (timeout/erro)
Estaciona para conciliação — nunca cobra duas vezes.
Autorizado → recebível
Provisionado no ledger, por seller e ambiente.
snapshot flow/step + adquirentes tentadas gravados na charge
O que a Bunne entrega
Fallback sem cobrar duas vezes
Se a adquirente recusa de forma limpa, a Bunne tenta a próxima em ordem de prioridade. Se o resultado é ambíguo (timeout/erro), a cobrança é estacionada para conciliação — nunca uma segunda tentativa que cobraria o cliente de novo.
PIX, cartão e boleto
Uma API pública provider-agnostic para os três métodos; Pagar.me validado em produção, Cielo e Rede em produção.
Conciliação e park
Resultados ambíguos viram uma fila de “cobranças a conferir” e um sweep que auto-resolve as definitivas, deixando só a dúvida para o humano.
Cartão, PIX e boleto: Disponível. Scoring dinâmico de rota: Em breve.
Como funciona
- 01
Publique o Payment Flow
Um AcquirerFlow por método define, por condição (bandeira, valor, parcela), qual adquirente atende e em que ordem de prioridade. O flow publicado fica versionado.
- 02
A cobrança entra tokenizada
O checkout envia o cartão já tokenizado por uma API provider-agnostic (PIX, cartão, boleto). Dado de cartão cru nunca chega à cobrança.
- 03
Roteamento determinístico
A Bunne resolve a cadeia de adquirentes do flow e tenta a primeira em ordem de prioridade. O snapshot de flow/step fica gravado na própria charge.
- 04
Fallback limpo ou park
Recusa limpa (antes de autorizar) → tenta a próxima adquirente. Resultado ambíguo (timeout/erro) → estaciona para conciliação, nunca uma segunda tentativa que cobraria de novo.
- 05
Recebível e ledger
Autorizada, a cobrança vira recebível provisionado e lançamentos no ledger, por seller e ambiente. As adquirentes tentadas ficam registradas para auditoria.
Perguntas frequentes
A Bunne pode cobrar o cliente duas vezes no fallback?
Não. O fallback só ocorre após uma recusa limpa, antes de qualquer autorização. Se o resultado é ambíguo (timeout/erro), a cobrança é estacionada para conciliação — nunca há uma segunda tentativa em outra adquirente.
Como decido qual adquirente atende cada transação?
Você publica um AcquirerFlow por método; as condições (bandeira, valor, parcela) e a prioridade dos steps definem a ordem. É determinístico e auditável — nada de caixa-preta.
Quais métodos e adquirentes são suportados?
PIX, cartão (à vista e parcelado) e boleto por uma API provider-agnostic; drivers de adquirência Cielo, Rede, Stone, Pagar.me e Braspag.
Consigo saber por qual rota a transação passou?
Sim. O snapshot de flow/step (public ids e versão) fica gravado na própria cobrança, e a lista de adquirentes tentadas fica registrada para auditoria.
Preciso trocar de core financeiro para trocar de adquirente?
Não. A adquirência é um driver substituível atrás da interface de provider; o core financeiro (recebíveis, ledger, repasses) é seu e não muda.
Já tem scoring dinâmico de rota?
Ainda não. A ordem vem de prioridade mais condições do flow; o scoring dinâmico de rota está no roteiro, não entregue.