Roteador beta v1 · 5 gateways SDKs em TypeScript · Python · Go · PHP Idempotência por padrão 99.99% uptime SLA Roteador beta v1 · 5 gateways SDKs em TypeScript · Python · Go · PHP Idempotência por padrão 99.99% uptime SLA

Decida qual gateway processa cada venda.

O primeiro roteador de pagamentos do Brasil. Conecte Stripe, Pagar.me, Mercado Pago, PagSeguro e Asaas. Configure regras por método, país, BIN ou valor. Fallback automático em milissegundos. Webhooks unificados. Uma SDK pra tudo.

// router config
export const routing = defineRouter({
  default: 'pagar_me',
  rules: [
    { method: 'pix',    use: 'asaas' },
    { method: 'card',   use: 'pagar_me' },
    { country: '!BR',   use: 'stripe' },
  ],
  fallback: 'auto',
});
PIX Asaas D+0
CARD Pagar.me D+30
USD Stripe D+7
BOLETO PagSeguro D+2
Os cinco gateways

Cinco infraestruturas. Uma só integração.

Pagar.me

Recomendado · Brasil

Stone group
Taxa típica cartão
2,99%
Prazo
D+30
Aprovação média
86%
3DS nativo
Sim
Cartão PIX Boleto Recorrência

Ideal para: volume alto de cartão, infoprodutores em escala, e quem precisa de antifraude robusto e parcelamento.

Stripe

Internacional · 135+ moedas

Global
Taxa típica
3,99%+R$0,39
Prazo
D+7 a D+14
Moedas
135+
Países
46
Cartão Apple Pay Google Pay Link SEPA

Ideal para: vendas internacionais, Apple/Google Pay, dropshipping global e produtores que querem alcance fora do Brasil.

Mercado Pago
MELI
Taxa cartão
4,99%
PIX
0,99%
Cartão PIX Boleto Saldo MP

Aprovação alta no público mainstream, fallback robusto.

PagSeguro
UOL
Taxa cartão
4,99%
Boleto
R$3,49
Cartão PIX Boleto

Forte em boleto e público mais tradicional.

Asaas
PIX D+0
Taxa PIX
R$1,99
Liquidação
D+0
PIX Cartão Boleto Recorrência

Melhor PIX D+0 do mercado para fluxo de caixa.

Como o roteador decide

Cada venda no gateway certo. Em milissegundos.

Cenário · Curso digital BR

Maximize aprovação

Aluna brasileira paga R$ 297 no cartão. O roteador identifica origem nacional, BIN crédito e valor e escolhe o gateway com melhor taxa + aprovação histórica.

Pagar.me 2,99% · 86% aprov.
Mercado Pago fallback
Cenário · Venda internacional

Receba em USD/EUR

Cliente americano paga US$ 49 num e-book. País detectado: US. Roteador automaticamente aciona o Stripe pra processar em moeda forte sem IOF.

Stripe USD · global
Cenário · Lançamento alta demanda

Sobreviva ao pico

Black Friday, lote 1, 6.000 vendas/min. Pagar.me começa a soltar timeouts. Em <120ms o tráfego já está distribuído entre 3 gateways automaticamente.

Pagar.me 60%
Mercado Pago 25%
PagSeguro 15%
Critérios de roteamento

Roteie por qualquer dimensão da venda.

01 — Method

Por método

PIX num gateway, cartão em outro, boleto no terceiro. Nunca mais use uma taxa de cartão pra pagar PIX.

{ method: 'pix', use: 'asaas' }
02 — Country / Currency

Por país

Vendeu pra fora do Brasil? Stripe assume. Vendeu pra alguém com BIN BR? Pagar.me. Sem IOF desnecessário.

{ country: '!BR', use: 'stripe' }
03 — BIN / Bandeira

Por BIN

Cartões corporativos, Platinum e Black em um gateway de aprovação alta. Pre-pago e Visa Electron em outro.

{ bin: ['557172'], use: 'pagar_me' }
04 — Valor

Por valor

Tickets baixos no gateway de menor taxa. Tickets altos no de maior limite e antifraude mais robusto.

{ amount: { gt: 100000 }, use: 'pagar_me' }
05 — Carga ponderada

Por peso

Distribua carga entre N gateways para diluir risco e melhorar aprovação. Round-robin com pesos.

{ split: { pagar_me: 60, mp: 40 } }
06 — Customizado

Por qualquer coisa

Função custom que recebe a request e retorna o gateway. Lógica do seu negócio, no JS, executada na borda.

{ when: (ctx) => ctx.user.tier === 'vip' }
Fallback automático

Quando um gateway falha, o próximo já está pronto.

Detectamos três tipos de falha em milissegundos. Se a regra é fallback: 'auto', tentamos o próximo gateway sem que a aluna nem perceba — ela continua na mesma tela de checkout.

Hard fail
~80ms
Gateway retorna erro definitivo (ex: 5xx).
Timeout
3.5s
Gateway não responde no SLA configurado.
Soft decline
~120ms
Recusa do banco recuperável (insuficiente, etc).
Ver na API
Tentativa de cobrança R$ 297,00 · CARD
1
Pagar.me timeout em 3.5s · 503 service unavailable
Falhou
2
Mercado Pago soft decline · cc_rejected_other_reason
Falhou
3
PagSeguro authorized · captured · 312ms
Aprovado
Tempo total: 4.0s Receita preservada: R$ 297,00
A API

Uma SDK. Cinco gateways. Zero amarras.

SDKs em 6 linguagens TypeScript, Python, Go, PHP, Ruby e .NET. Tipagem forte, idiomática, com autocomplete pra todos os parâmetros de todos os gateways.
Idempotência por padrão Idempotency-Key em todas as rotas mutáveis. Retry seguro. Zero cobranças duplicadas.
CLI + Sandbox Tunelamento de webhooks com toktus listen. Cartões de teste pra cada gateway, e environment isolado.
Migração sem downtime Mude de gateway sem mexer em uma linha de código. As regras vivem no painel — você ajusta, salva, e a próxima request já vai pro novo destino.
Documentação completa
TypeScript Python Go cURL
import { Toktus } from '@toktus/sdk';

const pay = new Toktus(process.env.TOKTUS_KEY);

// Uma chamada. Roteamento + fallback automático.
const charge = await pay.charges.create({
  amount: 29700,                  // R$ 297,00
  currency: 'BRL',
  method: 'credit_card',
  card: { token: req.body.token },
  customer: {
    name: 'Maria Souza',
    email: 'maria@exemplo.com',
    document: '123.456.789-00',
  },
  metadata: { product: 'curso-react' },
}, {
  idempotencyKey: req.headers['x-request-id'],
});

// Logs do que aconteceu por baixo dos panos:
console.log(charge.gateway);     // 'pagar_me'
console.log(charge.attempts);    // 1
console.log(charge.status);      // 'approved'
console.log(charge.fee);         // 8.88 (taxa do gateway)
console.log(charge.platformFee); // 2.67 (nossa taxa)
Webhooks

Um endpoint pra todos. Não cinco diferentes.

Antes — direto nos gateways

Cinco webhooks diferentes

POST /webhook/stripe
POST /webhook/pagarme
POST /webhook/mercadopago
POST /webhook/pagseguro
POST /webhook/asaas

Cinco formatos JSON diferentes. Cinco assinaturas pra validar. Cinco retry policies. Cinco vezes mais código.

Depois — Toktus

Um webhook pra tudo

POST /webhook/toktus
POST
POST
POST
POST

Schema unificado. Assinatura única. Retry com backoff exponencial. Replay de 30 dias. Logs e debugger nativos.

Casos reais

Quem está roteando do jeito certo.

Curso · BR Mariana
Mariana Costa
Curso de design · 8k alunas

Saiu da plataforma , conectou Pagar.me + Asaas e ganhou 6 pontos de margem.

PIX→ Asaas (R$1,99/tx)
Cartão→ Pagar.me (2,99%)
Fallback→ Mercado Pago
Margem ganha/mês +R$ 18.420
SaaS · Global Lucas
Lucas Almeida
CTO · SaaS B2B

Atende Brasil e Europa. Cada moeda no seu gateway.

BR→ Pagar.me
EU/US→ Stripe (multi-currency)
Webhooks→ 1 endpoint só
Linhas de código apagadas −812
Eventos · Volume alto Júlia
Júlia Mendes
Produtora · 80k ingressos/mês

Black Friday: Pagar.me caiu, fallback rodou em 120ms e ninguém percebeu.

Primary→ Pagar.me (60%)
Split→ Mercado Pago (25%)
Backup→ PagSeguro (15%)
Receita salva no incidente R$ 412k
FAQ técnico

Perguntas de quem vai integrar.

Como funciona a idempotência?
Toda rota mutável aceita o header Idempotency-Key. Se a mesma key cair na mesma rota dentro de 24h, retornamos o mesmo resultado da primeira tentativa — mesmo que o gateway diferente tenha sido escolhido. Zero risco de cobrança duplicada.
Vocês ficam com o dinheiro em algum momento?
Não. O Toktus é apenas um roteador — fluxo de dados, não de dinheiro. A transação acontece direto entre o seu cliente e o seu gateway. O dinheiro cai na sua conta do gateway no prazo que você combinou com ele. Nunca custodiamos saldo.
Como funciona o sandbox?
Cada conta tem um environment de teste isolado, com cartões de teste documentados pra cada gateway. O CLI toktus listen faz tunelamento dos webhooks pra sua máquina local — você nunca mais precisa expor um ngrok pro mundo.
Se eu trocar de gateway, perco histórico?
Não. O Toktus mantém o histórico unificado mesmo se você trocar todos os gateways. Cada cobrança guarda metadata de origem (qual gateway, qual tentativa, qual taxa), e os relatórios continuam consistentes ao longo do tempo.
Como ficam LGPD e PCI-DSS?
Somos PCI-DSS Level 1 — você nunca toca em dados de cartão. Nosso campo de cartão é tokenizado direto no navegador via Elements. Pra LGPD, fornecemos DPA padronizado, exportação de dados por API e logs de acesso completos.
E se um gateway novo lançar amanhã?
Você não precisa fazer nada. Adicionamos novos gateways com regularidade — quando virar adapter oficial, basta ativar no painel e usar o nome dele nas suas regras de roteamento. Seu código de integração não muda.

Pare de pagar duas vezes
pelo mesmo pagamento.

Começar a rotear → Falar com engenharia

Sem cartão de crédito · Sandbox aberto · 5.000 transações/mês grátis