--- title: 'HTTP 402 Payment Required: significado, historia y x402 | RunAPI' description: Qué significa el código de estado HTTP 402 Payment Required, por qué estuvo décadas sin usarse, cuándo lo devuelven hoy las APIs y cómo x402 lo convierte en un flujo de pago. url: https://runapi.ai/es/http-402.md canonical: https://runapi.ai/es/http-402 locale: es updated: '2026-09-24' date: '2026-09-24' site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/http-402 zh-CN: https://runapi.ai/zh-CN/http-402 es: https://runapi.ai/es/http-402 ja: https://runapi.ai/ja/http-402 de: https://runapi.ai/de/http-402 fr: https://runapi.ai/fr/http-402 pt-BR: https://runapi.ai/pt-BR/http-402 ko: https://runapi.ai/ko/http-402 it: https://runapi.ai/it/http-402 nl: https://runapi.ai/nl/http-402 pl: https://runapi.ai/pl/http-402 tr: https://runapi.ai/tr/http-402 zh-TW: https://runapi.ai/zh-TW/http-402 zh-HK: https://runapi.ai/zh-HK/http-402 ar: https://runapi.ai/ar/http-402 x-default: https://runapi.ai/http-402 --- > HTML version: https://runapi.ai/es/http-402 > Site index for agents: https://runapi.ai/llms.txt # HTTP 402 Payment Required: qué significa y cómo lo usa x402 402 es el código de estado HTTP para una solicitud que necesita pago antes de que el servidor la satisfaga. Durante la mayor parte de su historia no tuvo un formato estándar. x402 le da uno. _Actualizado September 24, 2026 · 5 min de lectura_ ## Key takeaways - 402 Payment Required es un error del cliente: la solicitud es válida, pero el servidor quiere el pago primero. - HTTP/1.1 reservó el 402 para uso futuro y nunca definió cómo debía funcionar el pago, así que cada API lo usó de forma distinta. - x402 define las piezas que faltaban: un encabezado PAYMENT-REQUIRED con condiciones legibles por máquina y un pago firmado en el reintento. ## Qué significa 402 Payment Required Una respuesta 402 le dice al cliente que la solicitud en sí está bien pero no se atenderá hasta que se realice el pago. Pertenece a la familia 4xx porque el que tiene que actuar a continuación es el cliente, no el servidor. 402 es distinto de 401 Unauthorized y 403 Forbidden. 401 pide credenciales, 403 rechaza la solicitud de plano y 402 pide un pago. ## Por qué 402 estuvo sin usarse tanto tiempo El código se reservó cuando se escribió HTTP/1.1, con la expectativa de que más adelante llegara alguna forma de dinero digital. La especificación nunca dijo qué debía contener un cuerpo 402 ni cómo debía pagar un cliente, así que los navegadores nunca actuaron sobre él. Sin un formato compartido, las APIs que sí devolvían 402 lo usaban como un error simple: una cuenta se quedó sin créditos, se rechazó una tarjeta o se alcanzó un límite del plan. ## Cuándo devuelven 402 las APIs hoy Verás 402 en dos situaciones generales. - Errores de facturación de cuenta: la key es válida pero el saldo, la cuota o la suscripción no cubren la solicitud. La solución es recargar o mejorar el plan. - Cotizaciones de pago por solicitud: el servidor devuelve las condiciones de pago, y el cliente puede pagar y reintentar la misma solicitud. Así funciona x402. ## Cómo convierte x402 el 402 en un flujo de pago x402 pone condiciones legibles por máquina en un encabezado PAYMENT-REQUIRED: monto, activo, red y destinatario. Un cliente firma una autorización de stablecoin para esas condiciones, la envía de vuelta en un encabezado PAYMENT-SIGNATURE y recibe la respuesta con un recibo PAYMENT-RESPONSE. Como todo el intercambio es HTTP plano, un agente de IA con una wallet puede pagar una llamada a la API sin registrarse ni almacenar una API key. ## Cómo manejar un 402 en tu cliente Comprueba primero si hay un encabezado PAYMENT-REQUIRED. Si está, la respuesta es una cotización x402 y un cliente x402 puede pagarla. Si no está, lee el cuerpo del error: normalmente significa que la cuenta necesita más créditos o un plan distinto. ## FAQ sobre HTTP 402 ### ¿Es 402 Payment Required un error? Es un error del cliente dentro del rango 4xx, pero no significa que la solicitud estuviera mal formada. Significa que se necesita el pago antes de que el servidor continúe. ### ¿Cuál es la diferencia entre 402 y 401? 401 significa que el servidor necesita credenciales válidas. 402 significa que el servidor necesita un pago. Una API puede devolver 401 por una key incorrecta y 402 por una key válida sin saldo. ### ¿Los navegadores manejan el 402 automáticamente? No. Los navegadores muestran un 402 como cualquier otra página de error. El pago automático necesita un cliente que entienda un protocolo como x402. ### ¿Qué APIs usan 402 con x402? Cualquier servidor que implemente el protocolo x402. RunAPI devuelve cotizaciones x402 en sus endpoints de modelos de IA por llamada, así que un agente puede pagar en USDC la generación de imagen, video, música y audio. ## Páginas relacionadas - [API x402 para modelos de IA](https://runapi.ai/es/x402.md) - Paga por solicitud en USDC en Base sin API key. - [Catálogo de modelos](https://runapi.ai/es/models.md) - Todos los modelos y endpoints disponibles en RunAPI. - [Documentación para desarrolladores](https://runapi.ai/es/docs/guides) - Formatos de solicitud, consulta de tareas y códigos de error. - [Precios](https://runapi.ai/es/pricing.md) - Créditos, precios por llamada y detalles de facturación. Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only. ## Prueba un 402 que sí puedes pagar Envía una solicitud a un endpoint por llamada de RunAPI sin una key e inspecciona la cotización x402 que devuelve. - [Explorar modelos](https://runapi.ai/es/models.md) - [Leer la documentación](https://runapi.ai/es/docs/guides) --- ## More from RunAPI - [Home](https://runapi.ai/es/.md) ### Producto - [Catálogo de modelos](https://runapi.ai/es/models.md) - [Precios](https://runapi.ai/es/pricing.md) - [Proveedores](https://runapi.ai/es/models#all-models) ### Desarrolladores - [Documentación](https://runapi.ai/es/docs/guides) - [SDKs](https://runapi.ai/es/sdk.md) - [CLI](https://runapi.ai/es/cli.md) - [Servidor MCP](https://runapi.ai/es/mcp.md) ### Guías - [Claude Code vs Cursor](https://runapi.ai/es/claude-code-vs-cursor.md) - [Configuración de Cursor API](https://runapi.ai/es/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/es/openrouter-alternative.md) - [API x402](https://runapi.ai/es/x402.md) ### Empresa - [Enterprise](https://runapi.ai/es/contact.md) - [Contacto](https://runapi.ai/es/contact.md) ### Legal - [Términos](https://runapi.ai/es/terms.md) - [Privacidad](https://runapi.ai/es/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "es", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/es", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/es/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/es", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/esicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "Article", "headline": "HTTP 402 Payment Required: significado, historia y x402", "description": "Qué significa el código de estado HTTP 402 Payment Required, por qué estuvo décadas sin usarse, cuándo lo devuelven hoy las APIs y cómo x402 lo convierte en un flujo de pago.", "datePublished": "2026-09-24", "dateModified": "2026-09-24", "author": { "@type": "Organization", "name": "RunAPI" }, "publisher": { "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/es" }, "mainEntityOfPage": "https://runapi.ai/es/http-402" }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "¿Es 402 Payment Required un error?", "acceptedAnswer": { "@type": "Answer", "text": "Es un error del cliente dentro del rango 4xx, pero no significa que la solicitud estuviera mal formada. Significa que se necesita el pago antes de que el servidor continúe." } }, { "@type": "Question", "name": "¿Cuál es la diferencia entre 402 y 401?", "acceptedAnswer": { "@type": "Answer", "text": "401 significa que el servidor necesita credenciales válidas. 402 significa que el servidor necesita un pago. Una API puede devolver 401 por una key incorrecta y 402 por una key válida sin saldo." } }, { "@type": "Question", "name": "¿Los navegadores manejan el 402 automáticamente?", "acceptedAnswer": { "@type": "Answer", "text": "No. Los navegadores muestran un 402 como cualquier otra página de error. El pago automático necesita un cliente que entienda un protocolo como x402." } }, { "@type": "Question", "name": "¿Qué APIs usan 402 con x402?", "acceptedAnswer": { "@type": "Answer", "text": "Cualquier servidor que implemente el protocolo x402. RunAPI devuelve cotizaciones x402 en sus endpoints de modelos de IA por llamada, así que un agente puede pagar en USDC la generación de imagen, video, música y audio." } } ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Inicio", "item": "https://runapi.ai/es" }, { "@type": "ListItem", "position": 2, "name": "HTTP 402", "item": "https://runapi.ai/es/http-402" } ] } ] ```