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. La fila de liquidación nombra un proveedor de Pix de salida: la línea de Pix de Mercado Pago crea un cobro de entrada, así que el router no la usa para pay.
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 proveedor 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 resuelve la llamada 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 — Asaas o Celcoin 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 proveedor — para Pix, tarjeta y USDC solo el router elige quién liquida
- Vuelve un solo recibo, sin importar cuál rail realmente movió el dinero
Dónde está realmente cada riel.
Una regla para esta lista: lo que el código hace hoy, y hasta dónde se probó cada riel. Los pagos Pix se enrutan a los proveedores de salida de esta superficie, Asaas y Celcoin, y el failover se queda dentro del riel. La línea de Pix de Mercado Pago crea un cobro de entrada, así que el router la rechaza para pay. Boleto no pasa por el router: codespar_pay liquida un boleto existente en su propio camino de consulta y confirmación, ejercitado punta a punta contra el sandbox del proveedor. Tarjeta y USDC vía x402 están nombrados en la misma llamada gobernada. Cada fila dice lo que el código hace con ese riel; cuando un riel solo corrió contra el sandbox del proveedor, la fila dice sandbox.
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 se enruta a un proveedor de salida, Asaas o Celcoin, elegido por el router
- Boleto liquida en su propio camino de consulta y confirmació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 vivoLos pagos Pix se enrutan a los proveedores de salida de esta superficie, Asaas y Celcoin.
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.
No a través de Mercado Pago: su línea de Pix crea un cobro de entrada, así que el router no la usa para pay. codespar_pay enruta Pix a un proveedor de salida, Asaas o Celcoin, y Celcoin está probado en sandbox, todavía sin liquidar tráfico de producción.
Pix, boleto, tarjeta y USDC vía x402 están nombrados en la misma llamada gobernada. Hasta dónde se probó cada uno varía por riel, y la sección de cobertura de esta página dice cuál es cuál.
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: Los pagos Pix se enrutan a los proveedores de salida de esta superficie, Asaas y Celcoin.