Pagar por request
HTTP 402, x402 y lo que de verdad existe hoy en Stellar para cobrarle a personas y agentes, centavo por centavo.
Charla práctica · @bitfalt
Hola, soy bitfalt
- Backend Engineer en Nexus.
- Estudiante de maestría en el TEC.
- Hoy: HTTP desde cero, el código 402 y cómo se paga por request en Stellar.
La pregunta de hoy
¿Qué existe de verdad en Stellar para cobrar por cada request, y cómo funciona por dentro?
- 1HTTP en cortorequests, responses, headers, códigos
- 2402 y x402el código y el protocolo no son lo mismo
- 3¿Por qué ahora?agentes de IA, stablecoins y quién está detrás
- 4x402 en Stellarauth entries, facilitator y un simulador
- 5Qué existe hoyoficial, productos y prototipos
- 6Quiz y recursos
HTTP en corto
- ¿Qué pasa cuando abrís una página o llamás una API?
- ¿Qué trae un request y qué trae una response?
- ¿Para qué sirven los headers?
- ¿Qué dicen los códigos 200, 401, 403, 404… y 402?
Una conversación de dos mensajes
HTTP es el idioma de la web: un cliente manda un request y un servidor contesta con una response.
- Cliente: tu navegador, una app,
curl… o un agente de IA. - Servidor: el programa que tiene lo que pedís (una página, datos, una imagen).
- Cada request se responde una vez, y después el servidor se olvida de vos.
Anatomía: request y response
POST /usuarios HTTP/1.1Host: api.ejemplo.comContent-Type: application/jsonAuthorization: Bearer abc123 { "nombre": "Ana" }
HTTP/1.1 201 CreatedContent-Type: application/jsonLocation: /usuarios/42Date: Tue, 20 Oct 2026 05:28:36 GMT { "id": 42, "nombre": "Ana" }
Tocá una parte para ver qué hace.
Métodos: el verbo del request
| Método | Para qué | Ejemplo |
|---|---|---|
GET | Leer algo, sin cambiarlo | ver un perfil |
POST | Crear algo nuevo | registrar un usuario |
PUT | Reemplazar algo completo | guardar un perfil entero |
PATCH | Cambiar una parte | actualizar solo el correo |
DELETE | Borrar | eliminar un comentario |
En x402
El método no cambia: un GET pagado es un GET normal con un header extra. Por eso cualquier API existente se puede cobrar sin rediseñarla.
El precio se configura por ruta y método, por ejemplo "GET /chiste".
Códigos de estado: la respuesta en tres dígitos
Tocá un código
El primer dígito dice la familia: 2 salió bien, 4 el cliente hizo algo mal, 5 el servidor falló.
Probá: armá un request
Servidor simulado en el navegador. Retos: conseguí un 201, un 401, un 403, un 404 y un 402.
Cómo se cobra una API hoy
- 1Crear una cuenta y verificar el correo
- 2Poner una tarjeta de créditoy a veces pasar KYC
- 3Elegir un plan mensualpagás aunque uses poco
- 4Generar una API key y guardarla biensi se filtra, alguien gasta por vos
- 5Mandarla en
Authorizationen cada request - 6Factura a fin de mes
¿Y si el cliente es un agente?
Un agente de IA no llena formularios, no tiene tarjeta y no debería tener una llave con acceso ilimitado.
Lo que necesita: preguntar el precio, pagar exactamente eso y recibir el recurso, todo dentro de HTTP.
402 y x402
- ¿Por qué el 402 estuvo dormido casi 30 años?
- ¿Qué diferencia hay entre 402 y x402?
- ¿Quiénes participan en un pago x402?
- ¿Qué viaja exactamente en cada header?
El código que esperó 28 años
HTTP/1.1 (RFC 2068) define 402 Payment Required…“reservado para uso futuro”
RFC 2616: sigue reservado.
RFC 7231: sigue reservado.
RFC 9110, la spec vigente: todavía reservado.
Coinbase publica x402: un protocolo abierto que por fin dice cómo pagar.
x402 y MPP llegan a Stellar; en abril, a mainnet.
Arranca la x402 Foundation (Linux Foundation) con 40 miembros; SDF es Premier.
¿Por qué nadie lo usó?
Tarjeta: tarifa estándar publicada por Stripe en EE. UU., 2.9 % + US$0.30 por cobro. Stellar: la comisión real de nuestro pago de prueba, 11 755 stroops (0.0011755 XLM), que paga el facilitator.
Tarjeta, un cobro por request 2.9 % + US$0.30
x402 en Stellar comisión de red
402 no es lo mismo que x402
402
- Es un número con un significado: “hay que pagar”.
- Vive en la especificación de HTTP desde 1997.
- No dice cuánto, en qué moneda, a quién, ni cómo probar que pagaste.
x402
- Define 3 headers:
PAYMENT-REQUIRED,PAYMENT-SIGNATURE,PAYMENT-RESPONSE. - Define el JSON: precio, activo, red, destinatario, vencimiento.
- Define esquemas (
exact,upto…) y quién verifica: el facilitator. - Es multi-red: el facilitator de x402.org hoy acepta Base, Solana, Algorand, Aptos, Hedera, XRPL y Stellar.
MPP (Stripe y Tempo) es otro protocolo sobre el mismo 402. Stellar soporta los dos.
Cuatro actores en un pago x402
Cliente
Una app, un script o un agente. Tiene una wallet con USDC y firma el pago.
Servidor
Tu API. Pone precio a sus rutas y contesta 402 si no le pagaron. No toca la blockchain.
Facilitator
Revisa que el pago sea válido (/verify) y lo envía a la red (/settle). En Stellar, además paga la comisión.
Stellar
Mueve el USDC de verdad, en un ledger nuevo cada ~5 s.
El flujo real, header por header
Qué dice PAYMENT-REQUIRED
Y MPP, el primo
x402
Un pago on-chain por request. Un facilitator verifica y liquida, así que el cliente no necesita gas.
El foco de hoy.
MPP · Machine Payments Protocol
El mismo 402, con otro formato y dos modos:
- charge: pagás cada request.
- session: depositás una vez, firmás muchos pagos off-chain y se liquida al final.
Lanzó con más de 100 servicios integrados y su especificación se envió a la IETF.
En Stellar, los dos funcionan en mainnet desde abril de 2026. MPP vuelve en el modo agente.
¿Por qué ahora?
- ¿Qué cambió para que el 402 despierte?
- ¿Qué tienen que ver los agentes de IA?
- ¿Quién está apostando por x402?
- ¿Cuánto se usa de verdad?
Tres cosas cambiaron a la vez
Clientes que no son personas
Agentes de IA que usan herramientas y APIs por su cuenta (por ejemplo, vía MCP). No llenan formularios ni tienen tarjeta, pero sí necesitan pagar.
Dinero nativo de internet
Stablecoins como USDC y redes que liquidan en segundos por fracciones de centavo. Por fin, cobrar un centavo da números.
Un estándar neutral
x402 dejó de ser “de Coinbase”: lo gobierna una fundación abierta con redes de tarjetas, nubes, bancos y blockchains.
“We don't actually have a good way to exchange value” — hoy no hay una buena forma de que los agentes intercambien valor. Alin Dragos, AWS, presidente del board de la x402 Foundation (CoinDesk, 16 jul 2026)
¿Quién está detrás de x402?
La x402 Foundation (Linux Foundation) arrancó en julio de 2026 con 40 miembros. Estos son los 17 Premier; tocá uno.
Fijate en la mezcla: Visa, Mastercard y American Express junto a Coinbase, Circle y varias blockchains.
Los números, con lupa
Lectura honesta: crece rápido y la industria está adentro, pero el uso real todavía es chico. Es buen momento para aprender y construir, no para creerse todos los titulares.
x402 en Stellar
- ¿Qué tiene Stellar que encaja con micropagos?
- ¿Qué firma exactamente el cliente?
- ¿Qué revisa el facilitator antes de cobrar?
- ¿Qué pasa si algo sale mal? (simulador)
Por qué encaja Stellar
Un ledger nuevo cada ~5 segundos. El pago queda final, sin esperar confirmaciones extra.
El cliente no paga comisión. El facilitator la patrocina; el cliente solo necesita USDC.
Nativo, emitido por Circle. No es un token puenteado; se usa a través de su contrato SAC.
Auth entries de Soroban. El cliente firma un permiso puntual, no una transacción entera.
Se firma un permiso, no una tx
Lo que revisa el facilitator antes de cobrar
- 1Versión, esquema y red coincidenx402Version 2, exact, stellar:testnet
- 2Es exactamente un
transferalpayTopor elamountni un stroop menos, ni a otra cuenta - 3La firma es del
fromy no hay llamadas extranada escondido dentro del permiso - 4El permiso no se pasa del vencimiento permitidoledger actual + ceil(timeout / 5 s)
- 5La simulación contra el ledger actual sale bienhay saldo, hay trustlines, solo cambian esos dos saldos
Y se protege a sí mismo
Su propia cuenta no puede aparecer como from ni en ningún permiso: así nadie le hace pagar algo que no es la comisión.
En /settle vuelve a verificar todo desde cero antes de enviar.
Fuente: especificación del esquema exact para Stellar en el repo de x402.
Simulador: Tienda 402
1 · Elegí qué comprar
2 · Escenario
3 · Jugá
Modo agente con presupuesto
El límite lo puede imponer un contrato, no solo el código del agente: eso hacen las smart accounts de OpenZeppelin y proyectos como REAPP.
| requests pagados | transacciones on-chain | comisión total (XLM) | |
|---|---|---|---|
| x402 (exact) | 0 | 0 | 0 |
| MPP session | 0 | 0 | 0 |
Cada cuadro es un request. Azul: pagado. Rojo: el presupuesto ya no alcanza.
No es teoría: está en testnet
El 20 de octubre corrí un servidor y un cliente x402 (carpeta demo) con el facilitator público de x402.org.
- 402 en 13 ms
- 200 pagado en 11.3 s (verificar + enviar + esperar el ledger)
- El comprador pagó 0.01 USDC y 0 XLM
Mostrando datos guardados el 20 de octubre de 2026.
¿Qué existe de verdad en Stellar?
- ¿Qué es oficial y qué es de la comunidad?
- ¿Qué facilitator uso en testnet y en mainnet?
- ¿Qué productos ya están vivos?
- ¿Qué uso para mi caso?
El mapa, de abajo hacia arriba
Oficial: SDKs y repos
| Paquete o repo | Para qué | Versión (20 oct) |
|---|---|---|
@x402/stellar | Esquema exact de Stellar: cliente, servidor y facilitator | 2.28.0 |
@x402/express · next · hono | Middleware para cobrar rutas en tu servidor | 2.28.0 |
@x402/fetch · axios | Cliente que paga solo cuando recibe un 402 | 2.28.0 |
@stellar/mpp + mppx | MPP en Stellar: modos charge y session | 0.7.1 · 0.13.5 |
stellar/x402-stellar | Ejemplos oficiales: facilitator propio y un paywall con React | GitHub |
stellar/stellar-mpp-sdk | SDK y demo de MPP | GitHub |
Ojo: todos los @x402/* tienen que ir en la misma versión mayor. Mezclar v1 y v2 da errores silenciosos.
Facilitators y wallets
| Facilitator | Redes | Detalles |
|---|---|---|
| OpenZeppelin Channels oficial en docs | testnet y mainnet | API key (Bearer) en ambas; patrocina comisiones. El que nombra la doc de Stellar para mainnet. |
| x402.org Coinbase | solo testnet | Sin API key. El que usé en la prueba. |
| El tuyo SDK oficial | las dos | @x402/stellar/exact/facilitator; tu cuenta paga las comisiones. |
| Vellar comunidad | solo testnet | Sin auditoría independiente; incluye catálogo Bazaar. |
| Rail402 producto | Stellar | Facilitator + Bazaar + explorer de pagos x402. |
¿Este facilitator sirve mi red?
curl https://x402.org/facilitator/supported
{ "x402Version": 2, "scheme": "exact",
"network": "stellar:testnet",
"extra": { "areFeesSponsored": true } }
Respuesta real del 20 de octubre (recortada a Stellar).
Wallets que firman auth entries
Freighter (extensión), Albedo, Hana, HOT, Klever, OneKey, Scopuly.
Freighter Mobile todavía no soporta x402.
Productos del ecosistema
Fuente: directorio de Stellar vía Raven (Scout/Lumenloop), 20 oct 2026. “Live” y SCF según el directorio; no son auditorías.
Hecho en hackathons: inspiración, no producción
Stellar Hacks: Agents (ganadores)
- 2.º CleverCon: marketplace que divide tareas, contrata agentes y les paga con x402 o MPP.
- 3.º RenderGate: navegador headless que se paga por cada render.
- 4.º x402-mcp-stellar-template: middleware para cobrar a agentes en Node y Python.
- 5.º TollPay: “Stripe para servidores MCP”.
Desde Latinoamérica
- x402-Ramp: off-ramp modular para empresas en LATAM.
- Handle x402 (PULSO): enrutamiento económico para agentes en LATAM.
- M.I.A. (Stellar Chile): Shopify conectado a agentes vía x402.
Raven encuentra unos 40 proyectos de hackathon con x402 en Stellar. La mayoría son prototipos: sirven para ver ideas y código, no para producción.
Herramientas para que tu agente no adivine
Raven (MCP)
Docs, directorio de proyectos, hackathons y playbooks de Stellar desde tu agente.
claude mcp add --transport http \ stellar-raven \ https://raven.stellar.org/mcp
Después /mcp → Authenticate.
Stellar Dev Skill
Incluye la skill agentic-payments: x402, MPP, errores comunes y checklist de mainnet.
/plugin marketplace add stellar/stellar-dev-skill /plugin install stellar-dev@stellar-dev
llms.txt
Resumen de la documentación de Stellar pensado para modelos.
developers.stellar.org/llms.txt
Esta charla se investigó con Raven + la skill.
¿Qué uso para mi caso?
Repaso rápido
Ahora te toca cobrar algo
402 es el aviso, x402 es el cómo, y llega justo cuando los agentes necesitan pagar. Stellar ya tiene SDKs, facilitators y un ecosistema para usarlo.
- developers.stellar.org/docs/build/agentic-payments
- x402.org · docs.x402.org
- github.com/stellar/x402-stellar
- raven.stellar.org
- El código de la prueba real está en la carpeta
demo:npm run setup,serveryclient.
