Orquestração de pagamentos feita para a complexidade de marketplaces.
Múltiplos vendedores. Múltiplos provedores. Múltiplas regiões. Múltiplas regras de split. Pagamentos de marketplace não são uma única integração — são um sistema operacional cuja complexidade se acumula a cada vendedor que você integra. A Tokeflow oferece a camada de orquestração para gerenciar isso sem montar um time de pagamentos.
Pagamentos de marketplace são um problema diferente.
Em uma operação de e-commerce padrão, uma entidade vende, uma entidade recebe, um provedor processa. Em um marketplace, toda transação envolve pelo menos três partes — o comprador, o vendedor e a plataforma — cada uma com interesses e obrigações diferentes.
A plataforma retém uma comissão. O vendedor recebe o restante. Pode ser necessário reter impostos. O método de pagamento pode variar por região. E se uma transação falha, a lógica de cascata precisa respeitar a configuração de split — não tentar de novo às cegas. A maioria das integrações de pagamento não foi projetada para isso.
Os problemas que se acumulam a cada vendedor que você integra.
Lógica de split que quebra quando você troca de provedor
Os splits de comissão são simples até que as APIs mudem, você adicione um segundo provedor ou as regras de imposto exijam um split de três partes. A maioria das plataformas codifica a lógica de split de forma rígida contra um único PSP — quando isso quebra, depurar durante uma disputa com o vendedor custa confiança.
O que isso custa a você: Fragilidade de engenharia. A lógica de split vira o código mais mexido e menos compreendido da sua stack.
Configuração no nível do vendedor em escala de plataforma
O Vendedor A usa Pix no Brasil; o Vendedor B usa Stripe nos EUA; o Vendedor C traz o próprio adquirente. Sua plataforma precisa suportar tudo isso simultaneamente — sem uma integração customizada por vendedor.
O que isso custa a você: Velocidade de onboarding. Vendedores fora do padrão puxam a engenharia para cada onboarding.
Visibilidade operacional em uma stack fragmentada
Cada provedor tem o próprio painel, webhooks, IDs e taxonomia de recusas. Responder “qual é a taxa de aprovação dos vendedores da categoria X em todos os provedores?” não deveria exigir juntar planilhas.
O que isso custa a você: Sobrecarga operacional que escala a cada novo provedor.
O que muda com a Tokeflow no seu marketplace.
Orquestração ciente do split
Defina comissão, repasse ao vendedor e retenção de impostos no nível da plataforma. A Tokeflow mantém o roteamento e a interação com o provedor alinhados a essas regras quando você adiciona ou troca PSPs.
Orquestração Multi-Provedor · Roteamento Inteligente
Configuração de pagamentos por vendedor
Cada vendedor é mapeado para uma entidade de merchant com conectores, perfis de roteamento, webhooks e dados isolados. O onboarding é configuração — não um novo deploy.
Governança Multi-Tenant · Normalização de Webhooks
Camada operacional unificada
Um modelo de eventos, uma taxonomia de recusas, uma trilha de auditoria — com os payloads brutos dos provedores armazenados para disputas.
Normalização de Webhooks e Eventos · Auditoria e Rastreabilidade
Como marketplaces usam a Tokeflow.
Marketplaces multivendedor
Vendedores independentes com requisitos diferentes, isolados por merchant, com uma visão unificada de comissões e transações.
Marketplaces de serviços e plataformas de gig
Comissão da plataforma, payout do provedor e retenção de impostos — orquestrados entre provedores com regras de split consistentes.
Marketplaces verticais
Padronize a experiência do comprador permitindo configuração por vendedor para métodos e roteamento.
Plataformas agregadoras
Muitos merchants, uma experiência — cada um opera de forma independente sob o modelo multi-tenant da Tokeflow.
Como uma transação de marketplace flui pela Tokeflow.
- O comprador inicia o pagamento — os dados de cartão são tokenizados; sua plataforma nunca armazena o PAN.
- A plataforma envia os parâmetros de split (ex.: 85% vendedor, 15% plataforma).
- O motor de roteamento seleciona o PSP a partir do perfil do vendedor.
- O PSP autoriza; recusas recuperáveis ou erros técnicos seguem em cascata para o fallback automaticamente.
- Eventos normalizados para os webhooks da plataforma e do vendedor.
- Trilha de auditoria completa: roteamento, cascatas, respostas, splits, entregas.
const payment = await tokeflow.payments.create({
merchant_id: 'merch_seller_042',
amount: 10000,
currency: 'BRL',
method: 'credit_card',
payment_method: { token: 'tok_card_...' },
routing: { profile_id: 'rp_seller_042_brl', fallback: true },
customer: { id: 'buyer_xyz' },
split: {
rules: [
{ destination: 'merch_seller_042', percentage: 85 },
{ destination: 'platform', percentage: 15 }
]
},
metadata: {
order_id: 'order_78901',
marketplace_category: 'electronics'
}
});
// payment.split_detail → settled amounts per destinationUma visão. Cada vendedor. Cada provedor.
Consultas de transação unificadas
Filtre por vendedores, provedores e métodos a partir de uma API — sem mais juntar exports de CSV manualmente.
Trace de roteamento por transação
Veja qual provedor foi selecionado, quais foram ignorados, o tempo de cada cascata e os motivos das recusas.
Taxonomia de recusas normalizada
Um vocabulário único entre Stripe, Mercado Pago, Paystack e os demais.
const results = await tokeflow.payments.list({
status: 'declined',
method: 'credit_card',
currency: 'BRL',
metadata: { marketplace_category: 'electronics' },
created_after: '2026-04-05T00:00:00Z',
created_before: '2026-04-12T00:00:00Z'
});O que muda nas operações de marketplace.
| Sem a Tokeflow | Com a Tokeflow | |
|---|---|---|
| Integrar um novo vendedor | Escolha de PSP, webhooks, testes de split | Crie o merchant → conectores → roteamento |
| Vendedor em uma nova região | Novo contrato, integração, código de split | Adicione conector + regra de roteamento |
| Indisponibilidade de provedor | Vendedores no PSP ficam fora do ar | Cascata automática |
| Vendedor contesta o payout | Painel + logs + código | GET /payments/:id/trace com detalhe do split |
| Investigação de pico de recusas | Exportar e juntar painéis | Consulta unificada + taxonomia |
| Adicionar Pix para vendedores no BR | Pix customizado + atualizações de split | Conector + rota; split inalterado |
Fronteiras claras para operações de marketplace.
| Responsabilidade | Seu marketplace | Tokeflow |
|---|---|---|
| Relações entre compradores e vendedores | Você é dono delas | — |
| UX e checkout do marketplace | Sua marca | — |
| Comissão e precificação | Suas regras | — |
| Integrações de provedores | — | API unificada |
| Roteamento e fallback por vendedor | Você define as regras | A Tokeflow executa |
| Normalização de webhooks | — | Um formato de evento |
| Trilha de auditoria de transações | — | Ciclo de vida completo + detalhe do split |
A Tokeflow não gerencia o seu marketplace. Ela gerencia a camada de pagamentos por baixo.
Não cuidamos do KYC dos vendedores, dos payouts ou da política de comissões. A Tokeflow fornece a orquestração para que você roteie transações, normalize eventos, isole vendedores e mantenha visibilidade entre provedores — sem contratar um time de operações de pagamento. A lógica do seu marketplace continua sendo sua; a infraestrutura passa a ser nossa.
Tocando um marketplace? Vamos falar de arquitetura de pagamentos.
Vamos mapear a sua estrutura de vendedores, o seu cenário de provedores e os seus requisitos de split — e então demonstrar como a Tokeflow orquestra transações multivendedor e multi-provedor em tempo real. Acesso ao sandbox incluído.
Veja a Tokeflow dentro do seu produto.
Compartilhe alguns detalhes sobre o seu caso de uso e agendaremos uma demo técnica sob medida para a sua stack. Acesso ao sandbox incluído.