Una llamada gobernada.Cualquier riel.
Tu agente llama pay una vez. El runtime verifica el mandato, elige el riel — USDC vía x402, Pix en Brasil — y sella el recibo. El agente nunca nombra un proveedor; eso lo hace el router.
Los nombres de los campos y la secuencia son reales — verificación de mandato, luego enrutamiento, luego liquidación, luego un recibo sellado. Pix vía Mercado Pago es el único riel de este rastro que realmente está liquidando en producción hoy.
Pagarle a un proveedor no debería tomar tres integraciones.
Enrutar dinero a un proveedor, un contratista, o un payout transfronterizo hoy significa conectar un PSP de Pix, un procesador de tarjetas y una wallet de stablecoin — tres SDKs, tres políticas de reintento, tres reportes de conciliación que hay que cuadrar a mano. Pay junta todo eso en una sola llamada.
El mandato decide qué está permitido. El router decide cómo.
Una llamada, verificada contra el mandato firmado antes de que nada se mueva, y luego enrutada al riel que corresponda: USDC liquidando vía x402, Pix para BRL. USDC/x402 es un slot de la misma wallet; el riel de Pix corre en el mismo runtime, no es una integración aparte.
La llamada, paso a pasoLa llamada que tu agente realmente hace.
Tu agente llama pay una vez — monto, destino, y la referencia del mandato. No hay parámetro de riel que configurar. El runtime verifica la llamada contra el mandato firmado primero, porque el tope tiene que regir antes de que el dinero se mueva, no después — luego el router la resuelve al proveedor que corresponda.
const session = await codespar.sessions.create({ mandate: mandate.id, }); const payment = await session.execute("codespar_pay", { input: { amount: 14250, // R$142.50 in centavos currency: "BRL", destination: "supplier_8f21a", mandateRef: mandate.id, // cap enforced before the call executes // no `rail` field — the router picks Pix, boleto, card, or USDC }, }); console.log(payment.result); // → { receiptId: "rcpt_9f2c1a4e", rail: "pix", status: "settled" }
codespar_pay es la misma llamada sin importar qué liquide por debajo — Mercado Pago para Pix hoy, otro proveedor mañana, sin que el código de tu agente cambie.
Qué hace esta cadena de llamadas
- El mandato se verifica antes de que la llamada se ejecute — gastar más allá del tope simplemente no pasa
- Sin campo de rail — solo el router decide Pix, boleto, DDA, tarjeta o USDC
- Vuelve un solo recibo, sin importar cuál rail realmente movió el dinero
Dónde está realmente cada riel.
Pix está probado en producción en Brasil hoy, a través de Mercado Pago. Un segundo proveedor de Pix (Celcoin) está probado en sandbox, todavía sin liquidar tráfico de producción. Boleto y DDA también liquidan en producción. Tarjeta y recursos USDC/x402 están nombrados en la misma llamada gobernada; revisa el dashboard para saber cuáles están en vivo en tu cuenta hoy.
Una llamada codespar_pay, dos destinos distintos. El router lee el mandato y elige el riel — la llamada que escribe tu agente no cambia.
- Pix liquida en producción vía Mercado Pago
- Boleto y DDA liquidan en producción, dentro de la misma llamada gobernada
- Cada llamada se verifica contra el mandato antes de ejecutarse
- Cada pago liquidado devuelve un recibo sellado y auditable
- La facturación ya está activa para las primeras organizaciones, a la tarifa publicada
- Pix vía Celcoin pasando de sandbox a liquidación en producción
- Tarjeta y USDC/x402 confirmados en vivo en producción para cada cuenta
- Facturación activada para cada organización, no solo el grupo del rollout
10 bps, piso R$0,05, tope R$2,00 por transacción.
Esa es la tarifa publicada para el dinero movido bajo mandato. La facturación se está activando org por org, todavía no se cobra universalmente — tu página de billing en el dashboard muestra si está activa en tu cuenta.
En vivoEn vivo — Pix ya probado en producción en Brasil.
Pay, respondido
No lo elige. El agente llama pay una vez; el runtime elige el riel según el mandato y lo disponible, y sella el recibo.
Sí, a través de Mercado Pago. Un segundo proveedor de Pix está probado en sandbox pero todavía no liquida tráfico de producción.
Pix, boleto y DDA liquidan en producción hoy; tarjeta y recursos USDC/x402 están nombrados en la misma llamada gobernada, llegando cuenta por cuenta.
El mandato — verificado antes de que la llamada se ejecute, no después.
La tarifa publicada es 10 bps, piso R$0,05, tope R$2,00 por transacción. La facturación se está activando cuenta por cuenta.
No. Los agentes nunca nombran un proveedor — eso lo hace el router, y cada decisión queda auditada.
La llamada falla en modo seguro. Nada liquida fuera del mandato, y la falla queda registrada en el recibo igual que quedaría un éxito.
No. CodeSpar mantiene las conexiones con los rieles; tu agente solo llama pay.
Cinco casos de negocio, una llamada gobernada.
Cada uno de abajo es un caso de uso real construido sobre este producto, no una hipótesis — el mismo flujo de mandato y riel, aplicado a su propio escenario.
Agente de cuentas por pagar
Paga Pix y boleto en la fecha de vencimiento de cada factura, dentro del mandato operativo.
Ver el caso de uso →Orquestador de payouts transfronterizos
Enruta el payout por el riel más barato según el destino — Pix, SPEI o USDC — cada transferencia firmada por mandato.
Ver el caso de uso →Agente de nómina de contratistas
Ejecuta el payout mensual de contratistas por Pix dentro de un mandato con tope, un recibo sellado por pago.
Ver el caso de uso →Agente de reembolsos de soporte
Reembolsa al cliente por el riel original en cuanto se valida el ticket, dentro del límite de gasto del agente.
Ver el caso de uso →Gasto máquina a máquina (x402)
Liquida la cotización x402 en USDC desde el slot de la wallet, dentro del tope por llamada, recibo sellado al mandato.
Ver el caso de uso →Paga cualquier cosa con una llamada gobernada.
El mandato decide qué está permitido; el router decide cómo.
pay: En vivo — Pix ya probado en producción en Brasil.