Skip to main content

Caso de uso · Contas a receber

Cobranças por Pix e boleto para seus agentes

Seu agente cria a cobrança. Seu cliente paga. A CodeSpar confirma o recebimento para o seu sistema atualizar a fatura ou liberar o pedido.

Comece em ambiente de teste, sem movimentar dinheiro real.

Fatura 1208 · ACME Distribuidora · 2 parcelas

"criar as duas parcelas da fatura 1208 da ACME, R$ 1.180,00 cada, vencimentos 06/10 e 20/10, e avisar o sistema de pedidos quando a primeira for paga"

Acordo · 2 parcelasR$ 2.360,00 · vencimentos 06/10 e 20/10acordado
Parcela 1/2 · cobrança criadaR$ 1.180,00 · vence 06/10 · pagável por Pix ou boletoem aberto
Paga por Pix · 14:03Recebimento confirmado e vinculado à cobrança+R$ 1.180,00paga
Seu sistema atualiza a faturaO sistema conectado recebeu a confirmação e liberou o pedido 1208feito
Parcela 2/2 · cobrança criadaR$ 1.180,00 · vence 20/10 · QR e código enviados pelo seu canalaberta até 20/10
Solicitação repetidaA mesma cobrança é devolvida; nenhuma segunda cobrança é criadamesma cobrança
Recebido · fatura 1208R$ 1.180,00 de R$ 2.360,00
cada pagamento é confirmado e vinculado à sua cobrançauma parcela sem pagamento fecha no vencimento

Execução do agente · dados de demonstração

Demo

Da cobrança à confirmação do pagamento.

Crie a primeira parcela, pague como cliente e veja a confirmação chegar ao seu sistema. Uma solicitação repetida e uma parcela vencida ficam como os outros cenários.

Demonstração interativa · dados ilustrativos
Atividade 0 entradas
Resultado simulado: nada ainda.

Comece pela primeira cobrança; Reiniciar volta ao início.

Fatura 1208 · ACME Distribuidora

Recebido · de R$ 2.360,00 acordados

R$ 0,00

Em aberto0
Pagas0
Expiradas0
Históriconada recebido ainda

Cada passo mostra o que o seu sistema vê: a cobrança, o pagamento e o estado da fatura.

Cobranças elimina a conferência manual entre cobrança, banco e pedido. Seu agente cria a cobrança uma vez, o pagamento é confirmado para o seu sistema, e o próximo passo roda a partir daí.

O fluxo, lado a lado

Da cobrança ao pagamento confirmado.

Seu agente cria e acompanha. A CodeSpar cobra e confirma. Seu sistema dá o próximo passo.

  1. 01Agente

    A cobrança é criada

    Seu agente cria uma cobrança por parcela: valor, vencimento, pagador. O cliente pode pagar por Pix ou boleto.

    fatura 1208 · 1/2 · R$ 1.180,00 · vence 06/10

  2. 02Cliente

    O cliente paga

    Por Pix com o QR ou o código, ou por boleto com a linha digitável, no app que já usa.

    Pix ou boleto · até 06/10

  3. 03CodeSpar

    O recebimento é confirmado

    O pagamento é confirmado, vinculado à cobrança e registrado no histórico da sua conta.

    recebimento confirmado · R$ 1.180,00

  4. 04Seu sistema

    O próximo passo roda

    O seu sistema conectado recebe a confirmação e atualiza a fatura ou libera o pedido.

    pedido 1208 liberado · pelo sistema conectado

Dois jeitos de pagar

No seu canal ou em uma página de pagamento.

Disponibilize o QR e o código de pagamento no WhatsApp, e-mail ou aplicativo que você já usa, ou compartilhe um link para uma página em que o cliente vê a cobrança e paga. A cobrança e a confirmação são as mesmas.

No seu canal

QR e código de pagamento onde você fala com o cliente

Seu agente lê o QR e o código da cobrança; a integração do seu projeto envia na conversa do WhatsApp, por e-mail ou no seu app.

cobrança criada · Pix ou boleto · vence 06/10QR + código enviados pelo seu canal→ paga · confirmação para o seu sistema

O envio pelo canal é feito pela integração do seu projeto.

Página Collect

Um link que o cliente abre para pagar

Compartilhe um link: o cliente vê a cobrança com o seu nome, preenche o que falta e paga por Pix.

link de pagamento criadoo cliente abre e paga→ paga · a mesma confirmação

A página mostra o seu nome como recebedor.

Por trás

Conecte seu agente ao seu fluxo de cobrança.

Crie a cobrança, acompanhe o estado, receba a confirmação de pagamento como evento e repita uma solicitação sem criar outra cobrança.

Integração · invoice 1208
Criarcodespar_charge · pix ou boleto · amount, due_date, buyer
Estadoaction status · em aberto, paga ou expirada
Confirmaçãocommerce.charge.paid · enviado ao seu endpoint
Solicitação repetidamesma idempotency_key · a mesma cobrança é devolvida
Registro do recebimentovinculado à cobrança · no histórico da sua conta
Três situações
PagaA parcela 1/2 é paga por Pix → a confirmação chega ao seu sistema → o pedido é liberado.
Sem pagamento no vencimentoA parcela 2/2 passa de 20/10 sem pagamento → fecha como expirada. Uma nova cobrança precisa de uma nova chave.
Com revisãoCom uma regra de aprovação no codespar_charge, cada cobrança do agente espera um operador antes de ser criada.
TypeScript · @codespar/sdk 0.16.11Exemplo do SDK
const session = await new CodeSpar().create("user_0000", { preset: "brazilian" });const run = await session.send("create instalment 1/2 of invoice 1208 for ACME Distribuidora: R$ 1,180.00, due 2026-10-06, boleto or Pix, key inv-1208-1");const charge = run.tool_calls.find((c) => c.tool_name === "codespar_charge");// paga: commerce.charge.paid chega ao seu endpoint · sem pagamento no vencimento: commerce.charge.expired

Exemplo do SDK · não roda nesta página

O que faz rodar
CollectCria a cobrança, por Pix ou boleto, e a página de pagamento.Abrir
TriggersEnviam a confirmação de pagamento ao seu endpoint.Abrir
AprovaçõesUma regra opcional coloca um operador antes de cada cobrança.Abrir
WalletRecebimentos, no mesmo histórico do que o agente gasta.Abrir
Seu canal e seu sistemaEnviar o código ao cliente e atualizar a fatura são feitos pela integração do seu projeto.

Cookbook

Duas parcelas, de ponta a ponta.

Uma chamada cria cada parcela com a sua chave; outra lê o estado. A confirmação de pagamento chega ao seu endpoint como evento.

  1. Uma chave de testeNo Dashboard. Chaves de teste são gratuitas; nada movimenta dinheiro real.
  2. Uma fatura a cobrarNome e documento do pagador, valor e vencimento por parcela, e uma chave que nomeia cada uma.
  3. Um endpoint para a confirmaçãoUm trigger no commerce.charge.paid. O seu handler casa a fatura e roda o próximo passo.
@codespar/sdk 0.16.11Exemplo do SDK
// 1 · uma chave de teste do Dashboard; um trigger no commerce.charge.paid aponta para o seu endpointimport { CodeSpar } from "@codespar/sdk";const session = await new CodeSpar().create("user_0000", { preset: "brazilian" }); // 2 · uma cobrança por parcela, Pix ou boleto com vencimento, sob uma chave que a nomeiaconst run = await session.send("create instalment 1/2 of invoice 1208 for ACME Distribuidora: R$ 1,180.00, due 2026-10-06, boleto or Pix, key inv-1208-1");const charge = run.tool_calls.find((c) => c.tool_name === "codespar_charge"); // 3 · o cliente paga por Pix ou boleto; acompanhe a cobrança até ser pagaif (charge) console.log((await session.paymentStatus(charge.id)).payment_status); // "succeeded"

Exemplo do SDK · não roda nesta página

Casos de uso relacionados

Caso de uso

WhatsApp: cobrança Pix no chat

Uma cobrança Pix dentro da conversa, paga no app do banco.

Caso de uso

Copiloto do CFO

Pague faturas aprovadas dentro da sua política de alçadas.

Caso de uso

Assistente financeiro para seus clientes

Uma plataforma oferece aos clientes PJ um assistente que paga e recebe sob um mandato que eles controlam.

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 · test mode
$ claude mcp add --transport http codespar https://connect.codespar.dev/mcp \    --header "Authorization: Bearer <chave de teste>"> "criar as duas parcelas da fatura 1208 da ACME, R$ 1.180,00 cada, vencimentos 06/10 e 20/10"  codespar_charge × 2 · Pix ou boleto · uma chave por parcela  1/2 paga por Pix · confirmação enviada ao seu endpoint · 2/2 aberta até 20/10

Ilustrativo · dados de demonstração

Agente de cobrança · CodeSpar