Pagos con Stablecoins para Agentes IA: La guia x402

Cuando un agente de IA recibe una respuesta HTTP 402 Payment Required, el protocolo x402 entra en acción. El agente lee los requisitos de pago del header de respuesta, construye un pago en stablecoin y liquida la transacción — todo sin intervención humana, sin redes de tarjetas de crédito ni rieles bancarios tradicionales.

x402 es un protocolo de pago diseñado para la web agéntica. Aprovecha el código de estado HTTP 402, largamente inactivo, para crear una capa de pago nativa para agentes de IA. Cuando un merchant devuelve HTTP 402, la respuesta incluye un header PAYMENT-REQUIRED con los detalles estructurados del pago: dirección de wallet, monto en USDC, red y expiración. El agente lo parsea, firma una transacción en stablecoin y devuelve la prueba de pago en un header PAYMENT-SIGNATURE.

La implementación de x402 incluye multiples capas de seguridad. La protección SSRF bloquea direcciones privadas RFC-1918, loopback y endpoints IMDS de la nube como URLs de facilitador. Toda comunicación con el facilitador requiere HTTPS. Un guard de precisión de punto flotante aplica MAX_SAFE_CENTS para prevenir errores de redondeo en montos de stablecoin, ya que USDC usa 6 decimales y la conversión a centavos debe ser exacta.

El settlement sigue un patron fire-and-forget via HTTP 202. El merchant inicia la verificación y retorna inmediatamente. Detras de escena, el settlement reintenta con backoff exponencial — 5 intentos a intervalos de 5s, 10s, 20s, 40s. Los pagos pendientes que exceden la ventana de expiración se marcan automaticamente como expirados, protegiendo tanto al merchant como al agente de transacciones atascadas.

Para aceptar pagos x402, un merchant configura una dirección de wallet y la red soportada en sus ajustes de protocolo. La plataforma genera respuestas HTTP 402 con el formato correcto del header PAYMENT-REQUIRED. Del lado del agente, el adaptador x402 detecta la respuesta 402, normaliza el intent de pago del header (convirtiendo unidades mínimas de USDC a centavos), y maneja el flujo de firma. Todo el ciclo — detección, normalización, pago y settlement — es gestionado por el protocol bridge.