API de x402 Pasarela de pagos para APIs y paywalls diseñada para cobrar micro pagos en redes EVM y stablecoins como USDC, ideal para monetizar endpoints REST y agentes IA
Resumen funcional El flujo es simple y seguro 1 El cliente realiza una petición HTTP al endpoint protegido con Accept text/html para navegadores o con un encabezado X-PAYMENT cuando se envía el pago programáticamente 2 Un Facilitator verifica la autorización llamando a POST /verify y devuelve isValid true y payer 3 Si la verificación es correcta el servidor puede aceptar la petición y posteriormente solicitar al Facilitator el pago final con POST /settle que devuelve success true y transaction hash
Soportes de red y activos x402 funciona sobre EVM y redes compatibles como base sepolia Polygon Avalanche e integra pagos con USDC usando EIP 712 para transferWithAuthorization así como pagos nativos en testnets. Para pruebas se puede obtener USDC en faucet.circle.com en Base Sepolia
Middleware para Node.js ejemplo con Express import express from express import paymentMiddleware from x402-express const app = express() const WALLET_ADDRESS = 0xYourWalletAddress app.use(paymentMiddleware(WALLET_ADDRESS,{ GET /api/premium: { price: $0.001, network: base-sepolia, config: { description: Acceso premium } } })) app.get(/api/premium,(req,res)=>{ res.json({ message: Acceso protegido, data: { secret: Contenido premium $0.001 } }) }) app.listen(4021,()=>{ console.log(Servidor escuchando https://localhost:4021) })
Clientes y librerías disponibles x402-fetch permite envolver fetch con firma y pago usando viem import { createWalletClient,http } from viem import { privateKeyToAccount } from viem/accounts import { wrapFetchWithPayment } from x402-fetch import { baseSepolia } from viem/chains const account = privateKeyToAccount(TEST_PRIVATE_KEY) const client = createWalletClient({ account, transport: http(), chain: baseSepolia }) const fetchWithPay = wrapFetchWithPayment(fetch,client) const response = await fetchWithPay(https://localhost:4021/api/premium) // obtiene JSON de respuesta
Integración con Coinbase Facilitator Existe integración opcional con Coinbase mediante el paquete @coinbase/x402 que usa credenciales CDP para crear Facilitators y gestionar verificaciones y liquidaciones de pago en su plataforma
Buenas prácticas y consejos habilitar CORS en Express cuando el frontend y el backend residan en distintos orígenes usar precios en integer para tokens con decimales y verificar validBefore validAfter y nonce en las autorizaciones EIP 712
Sobre Q2BSTUDIO Q2BSTUDIO es una empresa de desarrollo de software que ofrece soluciones a medida y consultoría tecnológica especializada en inteligencia artificial ciberseguridad y servicios cloud AWS y Azure Nuestra experiencia abarca desde aplicaciones a medida y software a medida hasta inteligencia de negocio y despliegues seguros en la nube Contamos con equipos expertos en ia para empresas y agentes IA que integran modelos avanzados en procesos productivos Para solicitar un desarrollo de aplicaciones a medida visite aplicaciones a medida y para proyectos de inteligencia artificial conozca nuestras soluciones en inteligencia artificial
Servicios complementarios Ofrecemos ciberseguridad y pentesting para asegurar integraciones de pago y APIs consulte nuestras auditorías y pruebas en servicios de ciberseguridad También implementamos soluciones de Business Intelligence y Power BI para explotar los datos de negocio y optimizar decisiones
Palabras clave integradas aplicaciones a medida software a medida inteligencia artificial ciberseguridad servicios cloud aws y azure servicios inteligencia de negocio ia para empresas agentes IA power bi
Recursos adicionales documentación oficial x402 whitepaper y repositorios GitHub proveen ejemplos y adaptadores para Express Hono Fastify y Next.js y facilitan la integración si se desea un acompañamiento técnico Q2BSTUDIO puede ayudar a implementar esta pasarela de pagos en su arquitectura API y crear flujos de monetización fiable y escalable
