Uma chamada governada.Qualquer trilho.
Seu agente chama pay uma vez. O runtime confere o mandato, escolhe o trilho — USDC via x402, Pix no Brasil — e sela o recibo. O agente nunca nomeia um provedor; quem faz isso é o router.
Os nomes dos campos e a sequência são reais — checagem de mandato, depois roteamento, depois liquidação, depois um recibo selado. Pix via Mercado Pago é o único trilho desse rastro que realmente está liquidando em produção hoje.
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ó.
O mandato decide o que é permitido. O router decide como.
Uma chamada, conferida contra o mandato assinado antes de qualquer coisa se mover, e depois roteada pro trilho que encaixa: USDC liquidando via x402, Pix pra BRL. USDC/x402 é um slot da mesma wallet; a linha Pix roda no mesmo runtime, não é uma integração separada.
A chamada, passo a passoA 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 trilho 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í o router resolve 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" }
codespar_pay é a mesma chamada não importa o que liquida por baixo — Mercado Pago pro Pix hoje, outro provedor amanhã, sem o código do seu agente mudar.
O que essa cadeia de chamadas faz
- O mandato é checado antes da chamada executar — gastar além do teto simplesmente não acontece
- Sem campo de rail — só o router decide Pix, boleto, DDA, cartão ou USDC
- Um único recibo volta, não importa qual rail moveu o dinheiro de fato
Onde cada trilho realmente está.
Pix está provado em produção no Brasil hoje, via Mercado Pago. Um segundo provedor de Pix (Celcoin) está provado em sandbox, ainda não liquidando tráfego de produção. Boleto e DDA também liquidam em produção. Cartão e recursos USDC/x402 estão citados na mesma chamada governada; confira o dashboard pra saber quais estão ao vivo na sua conta hoje.
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.
- Pix liquida em produção via Mercado Pago
- Boleto e DDA liquidam em produção, dentro da mesma chamada governada
- Toda chamada é conferida contra o mandato antes de executar
- Todo pagamento liquidado retorna um recibo selado e auditável
- A cobrança já está ativa pras primeiras organizações, na taxa publicada
- Pix via Celcoin saindo do sandbox pra liquidação em produção
- Cartão e USDC/x402 confirmados ao vivo em produção pra toda conta
- Cobrança ligada pra toda organização, não só o grupo do rollout
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 vivoAo vivo — Pix já provado em produção no Brasil.
Pay, respondido
Ele não escolhe. O agente chama pay uma vez; o runtime escolhe o trilho com base no mandato e no que está disponível, e sela o recibo.
Sim, via Mercado Pago. Um segundo provedor de Pix está provado em sandbox mas ainda não liquidando tráfego de produção.
Pix, boleto e DDA liquidam em produção hoje; cartão e recursos USDC/x402 estão citados na mesma chamada governada, chegando conta por conta.
O mandato — conferido antes da chamada executar, não depois.
A taxa publicada é 10 bps, piso R$0,05, teto R$2,00 por transação. A cobrança está sendo ligada conta por conta.
Não. Agentes nunca nomeiam um provedor — quem faz isso é o router, e toda decisão é auditada.
A chamada falha fechada. Nada liquida fora do mandato, e a falha fica registrada no recibo do mesmo jeito que um sucesso ficaria.
Não. A CodeSpar segura as conexões com os trilhos; seu agente só chama pay.
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.
Agente de contas a pagar
Paga Pix e boleto na data de vencimento de cada fatura, dentro do mandato operacional.
Ver o caso de uso →Orquestrador de payouts cross-border
Roteia o payout pelo trilho mais barato por destino — Pix, SPEI ou USDC — cada transferência assinada por mandato.
Ver o caso de uso →Agente de folha de prestadores
Executa o payout mensal de prestadores via Pix dentro de um mandato com teto, um recibo selado por pagamento.
Ver o caso de uso →Agente de reembolso de suporte
Reembolsa o cliente pelo trilho original assim que o chamado é validado, dentro do limite de gasto do agente.
Ver o caso de uso →Gasto máquina a máquina (x402)
Liquida a cotação x402 em USDC a partir do slot da wallet, dentro do teto por chamada, recibo selado ao mandato.
Ver o caso de uso →Pague qualquer coisa com uma chamada governada.
O mandato decide o que é permitido; o router decide como.
pay: Ao vivo — Pix já provado em produção no Brasil.