API

SmartRouter

2 min de leitura

Seleção automática de gateway por moeda, método e valor. Sobrescreva com metadata.gateway quando necessário.

Regras de Roteamento

Moeda	Método	Condição	Gateway
BRL	pix / boleto	Qualquer valor	`MERCADO_PAGO`
USD / EUR	card_token	Valor < $50	`STRIPE`
USD / EUR	card_token	Valor ≥ $50	`PAYPAL` Beta
Qualquer	Qualquer	`metadata.gateway` definido	Gateway especificado
Qualquer	Qualquer	Sem regra correspondente	`STRIPE` (fallback)

Status dos Gateways

Gateway Moedas Status Credencial

STRIPE BRL, USD, EUR Ativo sk_live_...

MERCADO_PAGO BRL Ativo APP_USR_...

PAYPAL USD, EUR Beta clientId:secret

MOCK Qualquer Dev only qualquer string

Sobrescrevendo o Roteamento

Use metadata.gateway para forçar um gateway específico, ignorando a lógica de roteamento automática:

{
  "idempotencyKey": "pedido-001",
  "amount": 25.00,
  "currency": "USD",
  "paymentMethodRequest": { "type": "card_token", "token": "tok_..." },
  "customer": { "id": "usr_1", "email": "[email protected]" },
  "metadata": {
    "gateway": "PAYPAL"
  }
}

O SmartRouter é executado no componente PaymentService antes de despachar para o gateway. Logs detalhados estão disponíveis em execution_history.