A dor
A venda fecha no WhatsApp, mas a cobrança sai do canal e a confirmação não volta para o sistema.
Quem usa
O operador de vendas ou atendimento que conduz a conversa.
Quem compra
O dono do negócio, ou a plataforma de atendimento que serve esses negócios.
O ganho
Carrinho, cobrança Pix e confirmação no mesmo fio, com o pagamento no seu ledger. Dinheiro saindo é um pedido à parte que a sua regra de aprovação pode segurar.
O fluxo, lado a lado
Do carrinho ao pagamento confirmado.
O agente cobra, o cliente paga no app do banco, o ledger registra. Dinheiro saindo é um pedido à parte que as suas regras podem segurar.
01Agente
Carrinho a partir da conversa
O copiloto monta o carrinho a partir do que o cliente escreveu; os preços vêm do seu catálogo.
Pedido #1047 · R$ 289,90 · Ilustrativo02CodeSpar
Cobrança Pix
O codespar_charge emite uma cobrança Pix com QR e código copia e cola. Com uma regra de aprovação na ferramenta, um operador aprova antes.
codespar_charge · Pix · 24 h03Cliente
Paga no app do banco
O cliente paga com o QR ou o código no app do banco. O pagamento é confirmado na cobrança.
payment_status · succeeded04Seu sistema
Ledger e a conversa
Dinheiro entrando é um lançamento no ledger. A sua integração com o WhatsApp avisa o cliente que o pedido está confirmado. Reembolso é um pedido novo: dinheiro saindo.
lançamento no ledger · #1047 confirmado
Dois jeitos de pagar
Dois jeitos de pagar. Um roda hoje.
O caminho B é o que roda hoje, no sandbox: uma cobrança Pix na conversa, paga no app do banco. O caminho A, pagar dentro do chat sob o mandato do próprio cliente, é para onde isso vai: depende de um banco ou parceiro e não existe hoje. Abaixo, como ficaria.
Caminho B · QR / copia e cola
SandboxPagar no app do banco, confirmado na conversa
O carrinho sai com QR Pix e código copia e cola. O cliente paga no app do banco; o pagamento é confirmado na cobrança e cai no seu ledger. A sua integração avisa na conversa.
Roda no sandbox com chave de teste. O envio no WhatsApp é a sua integração.
Caminho A · pagar dentro do chat
Direção · banco ou parceiroConfirmar e pagar na mensagem
O cliente toca uma vez e o assistente dele paga sob um mandato que o cliente deu ao banco ou a um parceiro: teto por compra, validade, favorecido verificado. Sem app do banco.
Direção. Depende do banco ou parceiro que guarda o mandato do cliente. Não existe hoje.
Caminho A · pagar dentro do chat
Confirmar e pagar na mensagem, como ficaria.
O mesmo carrinho. O cliente toca uma vez e o assistente dele paga sob um mandato que o cliente deu ao banco ou a um parceiro: teto, validade, favorecido verificado. Sem app do banco, sem redirecionamento. Nada disso existe hoje; depende desse banco ou parceiro.
Ilustrativo · dados de demonstração · Não existe hoje: depende do banco ou parceiro que guarda o mandato do cliente.
Por trás
Cobrança entrando, dinheiro saindo, cada um com sua regra.
O Collect emite a cobrança; o Pay envia o reembolso. Um mandato governa o que um agente gasta, então o lado da cobrança não tem mandato: ali, uma regra de aprovação opcional coloca uma pessoa antes da cobrança.
Exemplo do SDK · dados de demonstração · não roda nesta página
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
Uma cobrança Pix no chat, de ponta a ponta.
Uma chamada emite a cobrança, outra lê o status. Uma regra de aprovação, se você criar, segura a cobrança no Dashboard; o agente lê o resultado.
- Uma chave de testeNo Dashboard. Chaves de teste são gratuitas; nada movimenta dinheiro real.
- Uma regra de aprovação, se quiserAgente e ferramenta, definidos no Dashboard: codespar_charge para cobranças, codespar_pay para reembolsos.
- Uma conversaQualquer referência que o agente possa citar: cliente, itens, valor, número do pedido.
// 1 · uma chave de teste do Dashboard; uma regra de aprovação no codespar_charge é opcionalimport { CodeSpar } from "@codespar/sdk";const session = await new CodeSpar().create("user_0000", { preset: "brazilian" }); // 2 · o agente emite a cobrança Pix do pedido #1047: QR e código copia e colaconst run = await session.send("charge R$ 289.90 by Pix to Ana Souza for order #1047");const charge = run.tool_calls.find((c) => c.tool_name === "codespar_charge"); // 3 · o cliente paga no app do banco; acompanhe a cobrança até liquidarif (charge) console.log((await session.paymentStatus(charge.id)).payment_status); // "succeeded"Exemplo do SDK · dados de demonstração · não roda nesta página
Casos de uso relacionados