Abaixo do seu piso, um Pix para abastecer a carteira.
O agente lê o saldo em BRL da carteira com o codespar_wallet. Quando ele está abaixo do piso que o seu código define, gera um Pix copia-e-cola dinâmico no valor que você escolher. Quem controla a fonte de recursos paga, e o extrato mostra o crédito. A CodeSpar não vigia o saldo nem reabastece sozinha: o piso e a decisão são do seu agente.
Abaixo do piso, um Pix para abastecer a carteira.
Um exemplo com dados de demonstração: o agente lê BRL 180,00, abaixo do piso de R$ 500,00 que o seu código define, e gera um Pix dinâmico de R$ 1.000,00. A fonte de recursos paga e o extrato mostra o crédito.
- O piso é do seu código, não uma configuração da plataforma
- O Pix dinâmico só abastece a carteira quando alguém paga
- O extrato mostra o crédito depois do pagamento
A conversa é a parte fácil.
O float de pagamentos seca na pior hora. Alguém recarrega à mão, e até lá todo pagamento espera.
Acompanhar o saldo à mão
O agente lê o saldo com o codespar_wallet
Gerar uma cobrança Pix no portal do banco
A action=receive gera um Pix dinâmico no valor
Copiar o código e mandar para quem paga
O copia-e-cola volta na resposta, pronto para enviar
Conferir depois se o dinheiro entrou
A action=statement lista os lançamentos da carteira
Uma recarga que o seu código decide, um Pix que alguém paga.
O codespar_wallet lê o saldo (action=balance), gera um Pix copia-e-cola dinâmico para abastecer a carteira (action=receive, dynamic=true) e lista os lançamentos (action=statement). O seu agente guarda o piso e decide quando gerar; a fonte de recursos paga o Pix. A CodeSpar não vigia o saldo nem recarrega sozinha.
codespar_walletSaldo em BRL
CarteiraAbaixo do seu piso?
codespar_walletUm Pix dinâmico
PixA fonte de recursos paga
codespar_walletO extrato mostra o crédito
CarteiraO codespar_wallet com action=balance devolve o saldo da carteira por moeda. Com action=receive e dynamic=true ele gera uma cobrança Pix dinâmica na conta Celcoin por trás da carteira e devolve o copia-e-cola. Quando a fonte de recursos paga, o crédito aparece na action=statement. O piso e a decisão de recarregar são código do seu agente.
O código, e o que ele pressupõe.
// Prerequisites: CODESPAR_API_KEY set to a test key (csk_test_…) and a consumer // (user_0000) with a wallet. The floor is your code: CodeSpar does not watch the // balance, and the Pix funds the wallet only once someone pays it. import { CodeSpar } from "@codespar/sdk"; const session = await new CodeSpar().create("user_0000", { preset: "brazilian" }); const FLOOR_MINOR = 50_000; // R$ 500.00, your floor const TOP_UP_MINOR = 100_000; // R$ 1,000.00 const read = await session.execute("codespar_wallet", { action: "balance", consumer_id: "user_0000" }); const { balances } = read.data as { balances: { currency: string; balance_minor: number | string }[] }; const brl = Number(balances.find((b) => b.currency === "BRL")?.balance_minor ?? 0); if (brl < FLOOR_MINOR) { const pix = await session.execute("codespar_wallet", { action: "receive", consumer_id: "user_0000", amount: TOP_UP_MINOR, dynamic: true, description: "Wallet top-up", }); console.log(pix.data); // the copia-e-cola for the funding source to pay }
Exemplo com o SDK publicado (@codespar/sdk 0.16.11). Os pré-requisitos estão nos comentários. Compilar não prova a integração: rode primeiro em modo de teste.
codespar_walletLê o saldo e o extrato, e gera um Pix dinâmico para abastecer a carteira.
Comece com uma chave de teste.
Chaves de teste são gratuitas. Abra o sandbox, conecte os provedores que o seu projeto usa e veja quais ferramentas ele pode chamar antes de construir.