Centro de Recursos x402

Su guía completa sobre el protocolo HTTP 402 y x402: documentación, tutoriales, libros blancos y recursos para desarrolladores.

Bienvenido al Centro de Recursos x402

Ya sea un desarrollador que busca implementar APIs de pago por uso, un creador de contenido que desea monetizar su trabajo o un desarrollador de agentes de IA que construye capacidades de pago autónomas, este centro de recursos tiene todo lo que necesita para comenzar con x402 y HTTP 402.

El protocolo x402 transforma el código de estado HTTP 402, que ha estado inactivo durante mucho tiempo, en un mecanismo de pago potente y práctico. A continuación, encontrará documentación oficial, ejemplos de código, guías de integración y recursos comunitarios organizados por tema y nivel de competencia.

🚀 Inicio Rápido

¿Es nuevo en x402? Comience aquí para entender los conceptos básicos y tener su primera integración funcionando en minutos.

¿Qué es x402?

Una introducción completa al protocolo x402, incluyendo las características de la V2, autenticación de billetera y soporte multi-cadena.

¿Qué es HTTP 402?

Una mirada profunda a la historia del código de estado HTTP 402, cómo se compara con otros códigos y por qué finalmente es útil.

Cómo pagar con USDC

Guía paso a paso para usuarios: configurar su billetera, obtener USDC y realizar su primer pago x402.

📚 Documentación Oficial

Recursos autorizados del equipo del protocolo x402 y de los organismos de estándares web.

Sitio oficial de x402

Descripción general del protocolo, actualizaciones del ecosistema, demostraciones en vivo y guías de incorporación. Su fuente principal de noticias y anuncios sobre x402.

Libro blanco de x402 (PDF)

Especificación técnica completa que cubre el diseño del protocolo, detalles del flujo de trabajo, consideraciones de seguridad y directrices de implementación.

Repositorio GitHub de x402

Implementaciones de referencia de código abierto, código SDK, aplicaciones de ejemplo y directrices para contribuir.

🔧 Herramientas de Desarrollador y SDKs

Librerías y herramientas para ayudarle a integrar x402 en sus aplicaciones de forma rápida y segura.

Librerías del lado del servidor

Lenguaje Nombre del paquete Descripción
Node.js @x402/server Middleware para Express/Fastify para proteger endpoints con un gateway de pago 402.
Python x402-python Decoradores para Django/Flask para añadir requisitos de pago a sus vistas.
Go x402-go Middleware HTTP para frameworks web en Go.
Rust x402-rs Middleware para Actix/Axum con validación de pago asíncrona.

Librerías del lado del cliente

Plataforma Nombre del paquete Descripción
JavaScript/TypeScript @x402/client Cliente para el navegador y Node.js para manejar respuestas 402 y firmas de billetera.
React @x402/react Hooks y componentes de React para flujos de pago.
Python x402-requests Extensión para la librería Requests con manejo automático de 402.

📖 Guías de Integración

Tutoriales paso a paso para escenarios de integración comunes.

Guía de monetización de APIs

Aprenda a añadir precios de pago por llamada a su API REST o GraphQL. Cubre límites de tasa, niveles de precios y análisis de uso.

  • Configuración de endpoints de pago
  • Configuración de puntos de precio
  • Manejo de la verificación de pagos
  • Creación de dashboards de uso

Integración de muro de pago de contenido

Implemente micro-pagos para artículos, videos o descargas sin necesidad de suscripciones.

  • Restricción de contenido en el servidor
  • Fluido de desbloqueo en el cliente
  • Caché de contenido pagado
  • Seguimiento de ingresos

Configuración de pagos para agentes de IA

Permita que agentes autónomos accedan a recursos pagados y realicen pagos sin intervención humana.

  • Configuración de billeteras para agentes
  • Manejo automático de respuestas 402
  • Límites y controles de presupuesto
  • Registro y auditoría de pagos

Configuración multi-cadena

Acepte pagos en múltiples blockchains incluyendo Ethereum, Base, Polygon y Arbitrum.

  • Configuraciones específicas de cadena
  • Direcciones de contrato USDC
  • Estrategias de optimización de gas
  • Liquidación cross-chain

🌐 Estándares HTTP y Referencias

Documentación oficial de estándares web sobre códigos de estado HTTP y protocolos de pago.

MDN: 402 Payment Required

Referencia completa de Mozilla Developer Network sobre el código de estado 402, incluyendo compatibilidad de navegadores y notas de uso.

RFC 9110: Semántica de HTTP

La especificación oficial de la IETF para HTTP, que incluye la definición de 402 como un código de estado reservado.

Wikipedia: Códigos de estado HTTP

Contexto histórico, línea de tiempo del desarrollo del 402 y resumen de intentos de implementación a lo largo de los años.

Referencia de estados HTTP

Un sitio de referencia rápida para todos los códigos de estado HTTP con explicaciones y códigos relacionados.

💰 Recursos de USDC y Stablecoins

Entienda la capa de pago que impulsa las transacciones x402.

USDC de Circle

Documentación oficial sobre USDC, la stablecoin vinculada al dólar utilizada en los pagos x402. Aprenda sobre reservas, auditorías y cadenas compatibles.

Documentación para Desarrolladores de Circle

Documentación técnica para la integración de USDC, incluyendo referencias de API, SDKs y mejores prácticas.

Cadenas compatibles

x402 soporta USDC en múltiples redes para máxima flexibilidad.

  • Ethereum Mainnet - El mercado original y con mayor liquidez.
  • Base - El L2 de Coinbase con tarifas bajas.
  • Polygon - Transacciones rápidas y de bajo costo.
  • Arbitrum - Un L2 de Ethereum con un fuerte ecosistema DeFi.
  • Optimism - Otro popular L2 de Ethereum.

🎓 Rutas de Aprendizaje

Viajes de aprendizaje estructurados basados en su rol y objetivos.

Para Desarrolladores de APIs

  1. Lea ¿Qué es HTTP 402? para entender el código de estado.
  2. Estudie ¿Qué es x402? para los mecanismos del protocolo.
  3. Revise el Libro Blanco para detalles técnicos.
  4. Explore la implementación de referencia en GitHub.
  5. Implemente un endpoint de prueba en su entorno de desarrollo.
  6. Despliegue a producción con el monitoreo adecuado.

Para Creadores de Contenido

  1. Entienda cómo funcionan los pagos desde la perspectiva del usuario.
  2. Aprenda sobre las características de x402 V2, incluyendo la reutilización de sesiones.
  3. Elija una plataforma o CMS que soporte x402.
  4. Configure los precios para su contenido.
  5. Configure notificaciones de pago y análisis.

Para Desarrolladores de IA/Agentes

  1. Estudie el flujo del protocolo x402 para el manejo programático.
  2. Configure billeteras para agentes con límites de gasto apropiados.
  3. Implemente la detección automática de respuestas 402.
  4. Construya la lógica de decisión de pago.
  5. Añada funciones de registro y monitoreo de presupuesto.

🔗 Comunidad y Soporte

Conéctese con la comunidad x402 y obtenga ayuda cuando la necesite.

GitHub Discussions

Haga preguntas, comparta sus implementaciones y discuta mejoras en el protocolo con la comunidad.

Unirse a la discusión →

Stack Overflow

Preguntas y respuestas técnicas sobre problemas de implementación de x402. Use la etiqueta [x402] para visibilidad.

Ver preguntas →

Comunidad Twitter/X

Siga a @x402protocol para anuncios, consejos y noticias del ecosistema.

Contáctenos

¿Tiene preguntas sobre esta documentación? Envíenos un correo a [email protected].

📋 Comparativa: x402 vs. Soluciones de Pago Tradicionales

Entienda cómo se compara x402 con las opciones existentes de integración de pagos.

Característica x402 Stripe/PayPal Pagos Cripto Manuales
Micro-pagos (menos de $1) ✅ Eficiente ❌ Tarifas muy altas ⚠️ Gas variable
Sin necesidad de cuenta ✅ Solo billetera ❌ Cuenta obligatoria ✅ Solo billetera
Máquina a Máquina (M2M) ✅ Soporte nativo ❌ No soportado ⚠️ Complejo
Nativo de HTTP ✅ Código de estado 402 ❌ Redirecciones ❌ Flujos personalizados
Acceso Global ✅ Sin permisos ⚠️ Restricciones regionales ✅ Sin permisos
Liquidación Inmediata ✅ Blockchain ❌ Retraso de días ✅ Blockchain

🛡️ Mejores Prácticas de Seguridad

Consideraciones de seguridad esenciales al implementar x402.

📊 Análisis y Monitoreo

Rastree y optimice su implementación de pagos x402.

❓ Preguntas Frecuentes

¿Está x402 listo para producción?

Sí, x402 V2 está listo para producción y está siendo utilizado por múltiples aplicaciones. El protocolo cuenta con el respaldo de Coinbase y ha sido probado extensamente.

¿Cuáles son las tarifas de transacción?

Las tarifas dependen de la blockchain utilizada. Base y Polygon ofrecen tarifas de menos de un centavo, mientras que la Mainnet de Ethereum puede costar varios dólares por transacción.

¿Puedo aceptar múltiples monedas?

Actualmente, x402 se enfoca en USDC por su simplicidad y cumplimiento. El soporte para múltiples monedas está en el roadmap.

¿Cómo se manejan los reembolsos?

Los reembolsos se gestionan a nivel de aplicación. Dado que los pagos son on-chain, usted enviaría una transacción separada para reembolsar la billetera del usuario.

¿Se requiere KYC?

x402 no requiere permisos; no se necesita KYC para los usuarios. Sin embargo, como comerciante, usted puede tener obligaciones de cumplimiento dependiendo de su jurisdicción.