A dor
O agente precisa de um serviço pago e para, ou alguém põe um cartão da empresa no circuito sem limite.
Quem usa
O engenheiro que opera agentes em produção.
Quem compra
O líder de plataforma ou infraestrutura que é dono do orçamento.
O ganho
Um teto por chamada e um orçamento por mês, sem cartão a cada passo, e uma recusa sem nada pago quando o orçamento acaba.
O fluxo, lado a lado
Do pedido ao recibo, sob um orçamento.
O agente faz a chamada e paga por ela. As regras ficam entre cada chamada e o dinheiro.
01Agente
Pedido
O agente chama um endpoint com preço x402. O endpoint responde 402 com o preço em USDC.
402 · US$ 0,40 em USDC02CodeSpar
Regras
Teto por chamada, teto mensal e endpoint aprovado são verificados antes de qualquer pagamento.
teto US$ 1,00 · mês US$ 20,0003x402 · USDC
Pagamento
Dentro dos tetos, a chamada é paga em USDC e segue. Acima de qualquer um, é recusada e nada é pago.
−US$ 0,40 · x402 · USDC04Wallet · trilha de auditoria
Recibo
Cada chamada paga recebe um recibo assinado e um lançamento no ledger, ambos na trilha de auditoria.
rcpt_demo_41c2 · assinado
Por trás
Mandato, wallet, pagamento, recibo.
Uma chamada do agente. O resto é a plataforma: mandato, wallet, pagamento, recibo.
Exemplo do SDK · dados de demonstração · não roda nesta página
Dois jeitos de pagar
Pagar por chamada, ou comprar créditos.
Mesmo mandato, dois jeitos de pagar um provedor. Por chamada, o x402 paga o preço que o endpoint informa e a chamada segue. Um bloco de créditos é um pagamento mais o provisionamento do próprio provedor.
Caminho A · x402 por chamada
SandboxPague o 402, receba a resposta
O agente chama um endpoint pago, recebe um 402 com o preço em USDC, paga sob o mandato e a chamada segue. Acima do teto por chamada nada é pago.
Roda em modo de teste na Base Sepolia pela rota REST de gasto.
Caminho B · compra de créditos
Piloto / integraçãoComprar créditos de um provedor
O agente paga o provedor sob o mandato e o provedor credita a conta. O crédito em si é o fluxo do provedor, não da CodeSpar.
Depende do provisionamento do próprio provedor: um piloto ou uma integração.
O que existe hoje
Existe, sandbox, piloto ou direção: um rótulo por controle.
O que você roda hoje com uma chave de teste, o que roda no sandbox, o que depende de piloto ou integração e o que ainda é só direção.
Cookbook
Pagar por chamada sob um orçamento, em poucas linhas.
O consumidor assina o mandato na página de consentimento; o agente faz uma chamada REST por requisição paga. A mesma receita roda em modo de teste com uma chave de teste.
- Uma chave de testeNo Dashboard. Chaves de teste são gratuitas; nada movimenta dinheiro real.
- Um mandatoTeto por chamada, teto mensal e o endpoint aprovado. O Dashboard abre a página de consentimento; o consumidor assina.
- Uma fonte de recursos em USDCEm modo de teste as chamadas liquidam na Base Sepolia; a mainnet vem desligada por padrão.
// 1 · o consumidor assinou mnd_demo_cmp na página de consentimento: US$ 1,00 por chamada, US$ 20,00 por mês, um endpointimport { CodeSpar } from "@codespar/sdk";const cs = new CodeSpar(); // 2 · pagar uma chamada ao endpoint com preço x402, no máximo o teto por chamadaconst res = await cs.api.response("post", "/v1/consumers/mandates/{id}/spend", { path: { id: "mnd_demo_cmp" }, body: { amount_minor: 100, payee: "https://inference.example/v1/summarize", attempt_id: "call_0001" },}); // 3 · dentro dos tetos: pago em USDC, recibo assinado · acima deles: recusado, nada pagoif (res.ok) console.log(res.data.receipt?.id, res.data.payment.amountMinor); // rcpt_… 40else console.log(res.status); // 422Exemplo do SDK · dados de demonstração · não roda nesta página
Casos de uso relacionados