Por debajo de tu piso, un Pix para fondear la billetera.
El agente lee el saldo en BRL de la billetera con codespar_wallet. Cuando está por debajo del piso que fija tu código, genera un Pix copia-e-cola dinámico por el monto que elijas. Quien controla la fuente de fondos lo paga, y el extracto muestra el crédito. CodeSpar no vigila el saldo ni lo recarga por su cuenta: el piso y la decisión son de tu agente.
Por debajo del piso, un Pix para fondear la billetera.
Un ejemplo con datos de demostración: el agente lee BRL 180,00, por debajo del piso de R$ 500,00 que fija tu código, y genera un Pix dinámico de R$ 1.000,00. La fuente de fondos lo paga y el extracto muestra el crédito.
- El piso es de tu código, no una configuración de la plataforma
- El Pix dinámico fondea la billetera solo cuando alguien lo paga
- El extracto muestra el crédito después del pago
La conversación es la parte fácil.
El float de pagos se agota en el peor momento. Alguien lo recarga a mano, y hasta entonces cada pago espera.
Vigilar el saldo a mano
El agente lee el saldo con codespar_wallet
Generar un cobro Pix en el portal del banco
action=receive genera un Pix dinámico por el monto
Copiar el código y enviárselo a quien paga
El copia-e-cola vuelve en la respuesta, listo para enviar
Verificar después si llegó el dinero
action=statement lista los asientos de la billetera
Una recarga que decide tu código, un Pix que alguien paga.
codespar_wallet lee el saldo (action=balance), genera un Pix copia-e-cola dinámico para fondear la billetera (action=receive, dynamic=true) y lista los asientos (action=statement). Tu agente mantiene el piso y decide cuándo generarlo; la fuente de fondos paga el Pix. CodeSpar no vigila el saldo ni lo recarga por su cuenta.
codespar_walletSaldo en BRL
Billetera¿Por debajo de tu piso?
codespar_walletUn Pix dinámico
PixLa fuente de fondos paga
codespar_walletEl extracto muestra el crédito
Billeteracodespar_wallet con action=balance devuelve el saldo de la billetera por moneda. Con action=receive y dynamic=true genera un cobro Pix dinámico en la cuenta de Celcoin detrás de la billetera y devuelve su copia-e-cola. Cuando la fuente de fondos paga, el crédito aparece en action=statement. El piso y la decisión de recargar son código de tu agente.
El código, y lo que supone.
// 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 }
Ejemplo con el SDK publicado (@codespar/sdk 0.16.11). Los requisitos están en los comentarios. Compilar no prueba la integración: ejecútalo primero en modo de prueba.
codespar_walletLee el saldo y el extracto, y genera un Pix dinámico para fondear la billetera.
Empieza con una clave de prueba.
Las claves de prueba son gratuitas. Abre el sandbox, conecta los proveedores que usa tu proyecto y mira qué herramientas puede llamar antes de construir.