Uma chamada governada.Qualquer trilho.

Pagar um fornecedor não devia exigir três integrações.

Rotear dinheiro pra um fornecedor, um prestador, ou um payout internacional hoje significa plugar um PSP de Pix, uma processadora de cartão e uma wallet de stablecoin — três SDKs, três políticas de retry, três relatórios de reconciliação pra bater à mão. O Pay junta tudo isso numa chamada só.

A chamada que seu agente realmente faz.

Seu agente chama pay uma vez — valor, destino, e a referência do mandato. Não tem parâmetro de provedor pra setar. O runtime confere a chamada contra o mandato assinado primeiro, porque o teto tem que valer antes do dinheiro se mover, não depois — daí resolve a chamada pro provedor que encaixa.

const session = await codespar.sessions.create({
  mandate: mandate.id,
});

const payment = await session.execute("codespar_pay", {
  input: {
    amount: 14250,              // R$142.50 in centavos
    currency: "BRL",
    destination: "supplier_8f21a",
    mandateRef: mandate.id,     // cap enforced before the call executes
    // no `rail` field — the router picks Pix, boleto, card, or USDC
  },
});

console.log(payment.result);
// → { receiptId: "rcpt_9f2c1a4e", rail: "pix", status: "settled" }

Onde cada trilho realmente está.

Uma regra pra esta lista: o que o código faz hoje, e até onde cada trilho foi provado. Pagamentos Pix são roteados para os provedores de saída desta superfície, Asaas e Celcoin, e o failover fica dentro do trilho. A linha de Pix do Mercado Pago cria uma cobrança de entrada, então o router a recusa no pay. Boleto não passa pelo router: o codespar_pay liquida um boleto existente num caminho próprio de consulta e confirmação, exercitado ponta a ponta contra o sandbox do provedor. Cartão e USDC via x402 estão citados na mesma chamada governada. Cada linha diz o que o código faz com aquele trilho; quando um trilho só rodou contra o sandbox do provedor, a linha diz sandbox.

Uma chamada codespar_pay, dois destinos diferentes. O router lê o mandato e escolhe o trilho — a chamada que seu agente escreve não muda.

10 bps, piso R$0,05, teto R$2,00 por transação.

Essa é a taxa publicada pra dinheiro movido sob mandato. A cobrança está sendo ligada org por org, ainda não é cobrada universalmente — sua página de billing no dashboard mostra se está ativa na sua conta.

Ao vivoPagamentos Pix são roteados para os provedores de saída desta superfície, Asaas e Celcoin.

Cinco casos de negócio, uma chamada governada.

Cada um abaixo é um caso de uso real construído sobre este produto, não uma hipótese — o mesmo fluxo de mandato e trilho, aplicado ao seu próprio cenário.