Skip to main content

Caso de uso · Pagamentos a fornecedores

Agentes compram de fornecedores. Suas regras decidem.

O agente propõe o pagamento. Suas regras decidem se ele passa, espera ou para.

As chaves de teste são gratuitas.

Agent run · pedido de comprademo

"pagar o boleto do fornecedor de embalagens do PO-0418"

Pedido de compraPO-0418 · embalagens · R$ 1.180,00 · vence em 3 diasaberto
Checar o mandatoAbaixo do teto por transação de R$ 3.000,00 · R$ 6.120,00 de R$ 20.000,00 neste mêspermitido
Pagar por boletoPO-0418 na descrição · lançamento com categoria fornecedor−R$ 1.180,00pago
Recibo assinadorcpt_demo_8a31 · ed25519 · qualquer pessoa pode verificarassinado
Próximo pedido, acima do tetoPO-0421 · R$ 4.200,00 · aguarda aprovação no Dashboardaguardando
Teto mensal · outubroR$ 7.300,00 de R$ 20.000,00
1 aguardando aprovação · R$ 4.200,00aprovação no Dashboard · expira em 24 h

Agent run · demo data

O que o agente faz

Do pedido de compra ao recibo assinado.

O agente propõe e paga. Uma pessoa entra só acima do teto por transação.

  1. 01

    Pedido

    Um pedido de compra chega de compras. O agente lê fornecedor, valor, vencimento e a linha digitável do boleto.

    PO-0418 · R$ 1.180,00

  2. 02

    Mandato

    O teto por transação e o teto mensal são verificados antes de qualquer envio. Um pagamento acima do teto mensal é recusado.

    R$ 3.000,00 por transação · R$ 20.000,00 por mês

  3. 03

    Pagamento

    Abaixo do teto por transação, o boleto é pago. Acima dele, o pagamento espera uma pessoa no Dashboard; na aprovação roda o ciclo completo: saldo reservado, débito, recibo assinado.

    −R$ 1.180,00 · boleto

  4. 04

    Recibo

    Cada boleto pago recebe um recibo assinado e um lançamento com categoria fornecedor; a referência do pedido vai na descrição.

    rcpt_demo_8a31 · assinado

Por trás

As partes que fazem isso rodar.

Três chamadas do agente. O resto é a plataforma: mandato, pagamento, aprovações, recibo.

Mandato e regrasTeto por transação e teto mensal, assinados pelo consumidor e verificados antes de qualquer envio.Abrir
PayEnvia o pagamento sob o mandato.Abrir
AprovaçõesAcima do teto por transação, o pagamento espera no Dashboard. Um admin da organização decide; a aprovação expira em 24 h.Abrir
Recibo e trilha de auditoriaUm recibo assinado para cada boleto pago; toda ação governada na trilha de auditoria.Abrir
WalletFinancia o pagamento; cada débito é um lançamento no ledger com a sua categoria.Abrir
TypeScript · @codespar/sdk 0.16.11SDK real
const session = await new CodeSpar().create("user_0000", { preset: "brazilian" });const run = await session.send("pay the packaging supplier's boleto for PO-0418");const pay = run.tool_calls.find((c) => c.tool_name === "codespar_pay");// abaixo do teto: pago, rcpt_demo_8a31 · acima dele: approval_required, aguarda no Dashboard

Sandbox run · demo data

Mandato · mnd_demo_prc demo
Teto por transaçãoR$ 3.000,00 · acima dele uma pessoa aprova
Teto mensalR$ 20.000,00 / mês
FinalidadePagamentos a fornecedores
Validade31/12/2026

Demo

Acompanhe um pagamento a fornecedor do pedido à decisão.

Dois boletos contra o mesmo mandato: um abaixo do teto por transação, outro acima. Depois aprove o que ficou esperando.

Simulated demo · no real money
Atividade demo2 entradas
Boleto de fornecedor de R$ 4.200,00Acima do teto por transação de R$ 3.000,00 · aguarda aprovação no Dashboard−R$ 4.200,00aguardando aprovação
Boleto de fornecedor de R$ 1.180,00Abaixo do teto · pagamento de teste · recibo assinado−R$ 1.180,00pago
Resultado simulado: aguardando aprovação: acima do teto por transação.
Pedidos de compra demo

Saldo da wallet

R$ 13.620,00

Teto por transaçãoR$ 3.000,00
Pago neste mêsR$ 7.300,00
Aguardando aprovação1
Recibos assinados1

Pagamento de teste, nenhum fornecedor real.

Cookbook

Um pagamento a fornecedor, de ponta a ponta.

O consumidor assina o mandato na página de consentimento; o agente faz três chamadas no código. Um pagamento acima do teto por transação aguarda aprovação no Dashboard; o agente lê o status.

  1. Uma chave de testeNo Dashboard. Chaves de teste são gratuitas; nada movimenta dinheiro real.
  2. Um mandatoTeto por transação e teto mensal. O Dashboard abre a página de consentimento; o consumidor assina.
  3. Um pedido de compraQualquer referência que o agente possa citar: número do PO, fornecedor, valor, a linha digitável do boleto.
@codespar/sdk 0.16.11SDK real
// 1 · o consumidor assinou o mandato na página de consentimento: R$ 3.000,00 por transação, R$ 20.000,00 por mêsimport { CodeSpar, isApprovalRequired } from "@codespar/sdk";const session = await new CodeSpar().create("user_0000", { preset: "brazilian" }); // 2 · o agente paga o boleto do pedido de compraconst run = await session.send("pay the packaging supplier's boleto for PO-0418");const pay = run.tool_calls.find((c) => c.tool_name === "codespar_pay"); // 3 · abaixo do teto: pago · acima dele: aguarda aprovação no Dashboardif (pay && isApprovalRequired(pay.output)) console.log(pay.output.approval_id, pay.output.expires_at);else if (pay) console.log((await session.paymentStatus(pay.id)).payment_status); // "succeeded"

Sandbox run · demo data

Casos de uso relacionados

Caso de uso

Gasto com compute e API

Pague por chamada de API sob um orçamento.

Caso de uso

Pagamentos a fornecedores

Contas de fornecedores pagas sob um mandato.

Caso de uso

Assistente no WhatsApp

Checkout com cobrança Pix dentro do chat.

Dê aos seus agentes um jeito de pagar e receber.

Construir é grátis: MCP hospedado, SDK e sandbox.

As chaves de teste são gratuitas.

terminal · modo de testedemo
$ claude mcp add --transport http codespar https://connect.codespar.dev/mcp \    --header "Authorization: Bearer <chave de teste>"> "pagar o boleto do fornecedor de embalagens do PO-0418"  abaixo do teto por transação de R$ 3.000,00 · R$ 6.120,00 de R$ 20.000,00 neste mês  pago · rcpt_demo_8a31 · lançamento com categoria fornecedor

Sandbox run · demo data

Compras autônomas · CodeSpar