--- title: 'HTTP 402 Payment Required: significato, storia e x402 | RunAPI' description: Cosa significa il codice di stato HTTP 402 Payment Required, perché è rimasto inutilizzato per decenni, quando le API lo restituiscono oggi e come x402 lo trasforma in un flusso di pagamento. url: https://runapi.ai/it/http-402.md canonical: https://runapi.ai/it/http-402 locale: it 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/it/http-402 > Site index for agents: https://runapi.ai/llms.txt # HTTP 402 Payment Required: cosa significa e come lo usa x402 402 è il codice di stato HTTP per una richiesta che richiede un pagamento prima che il server la soddisfi. Per gran parte della sua storia non ha avuto un formato standard. x402 gliene dà uno. _Aggiornato September 24, 2026 · 5 min di lettura_ ## Key takeaways - 402 Payment Required è un errore client: la richiesta è valida, ma il server vuole prima il pagamento. - HTTP/1.1 ha riservato il 402 per uso futuro senza mai definire come dovesse funzionare il pagamento, quindi ogni API lo ha usato in modo diverso. - x402 definisce le parti mancanti: un header PAYMENT-REQUIRED con termini leggibili da macchina e un pagamento firmato al successivo tentativo. ## Cosa significa 402 Payment Required Una risposta 402 dice al client che la richiesta in sé va bene ma non verrà servita finché non viene effettuato il pagamento. Appartiene alla famiglia 4xx perché è il client, non il server, a dover agire successivamente. 402 è diverso da 401 Unauthorized e 403 Forbidden. 401 chiede credenziali, 403 rifiuta la richiesta senza appello, e 402 chiede un pagamento. ## Perché il 402 è rimasto inutilizzato così a lungo Il codice fu riservato quando venne scritto HTTP/1.1, con l'aspettativa che qualche forma di denaro digitale sarebbe arrivata in seguito. La specifica non ha mai detto cosa dovesse contenere un corpo 402 né come un client dovesse pagare, quindi i browser non hanno mai agito su di esso. Senza un formato condiviso, le API che restituivano 402 lo usavano come un semplice errore: un account senza crediti, una carta rifiutata o un limite di piano raggiunto. ## Quando le API restituiscono 402 oggi Il 402 si incontra in due situazioni generali. - Errori di fatturazione dell'account: la key è valida ma il saldo, la quota o l'abbonamento non copre la richiesta. La soluzione è ricaricare o passare a un piano superiore. - Preventivi a consumo: il server restituisce i termini di pagamento, e il client può pagare e ripetere la stessa richiesta. È così che funziona x402. ## Come x402 trasforma il 402 in un flusso di pagamento x402 inserisce termini leggibili da macchina in un header PAYMENT-REQUIRED: importo, asset, rete e destinatario. Un client firma un'autorizzazione stablecoin per quei termini, la rinvia in un header PAYMENT-SIGNATURE e riceve la risposta con una ricevuta PAYMENT-RESPONSE. Poiché l'intero scambio è semplice HTTP, un agente IA con un wallet può pagare una chiamata API senza registrarsi né memorizzare una API key. ## Gestire un 402 nel tuo client Controlla prima se è presente un header PAYMENT-REQUIRED. Se c'è, la risposta è un preventivo x402 e un client x402 può pagarlo. Se non c'è, leggi il corpo dell'errore: di solito significa che l'account ha bisogno di più crediti o di un piano diverso. ## FAQ su HTTP 402 ### 402 Payment Required è un errore? È un errore client nell'intervallo 4xx, ma non significa che la richiesta fosse malformata. Significa che serve un pagamento prima che il server continui. ### Qual è la differenza tra 402 e 401? 401 significa che il server ha bisogno di credenziali valide. 402 significa che il server ha bisogno di un pagamento. Una API può restituire 401 per una key errata e 402 per una key valida senza saldo. ### I browser gestiscono il 402 automaticamente? No. I browser mostrano un 402 come qualsiasi altra pagina di errore. Il pagamento automatico richiede un client che comprenda un protocollo come x402. ### Quali API usano 402 con x402? Qualsiasi server che implementa il protocollo x402. RunAPI restituisce preventivi x402 sui suoi endpoint di modelli IA a consumo, così un agente può pagare in USDC la generazione di immagini, video, musica e audio. ## Pagine correlate - [API x402 per modelli IA](https://runapi.ai/it/x402.md) - Paga per richiesta in USDC su Base senza API key. - [Catalogo modelli](https://runapi.ai/it/models.md) - Tutti i modelli e gli endpoint disponibili su RunAPI. - [Documentazione per sviluppatori](https://runapi.ai/it/docs/guides) - Formati delle richieste, polling dei task e codici di errore. - [Prezzi](https://runapi.ai/it/pricing.md) - Crediti, prezzi a consumo e dettagli di fatturazione. Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only. ## Prova un 402 che puoi davvero pagare Invia una richiesta a un endpoint RunAPI a consumo senza una key e osserva il preventivo x402 restituito. - [Esplora i modelli](https://runapi.ai/it/models.md) - [Leggi la documentazione](https://runapi.ai/it/docs/guides) --- ## More from RunAPI - [Home](https://runapi.ai/it/.md) ### Prodotto - [Catalogo dei modelli](https://runapi.ai/it/models.md) - [Prezzi](https://runapi.ai/it/pricing.md) - [Fornitori](https://runapi.ai/it/models#all-models) ### Sviluppatori - [Documentazione](https://runapi.ai/it/docs/guides) - [SDK](https://runapi.ai/it/sdk.md) - [CLI](https://runapi.ai/it/cli.md) - [MCP Server](https://runapi.ai/it/mcp.md) ### Guide - [Claude Code vs Cursor](https://runapi.ai/it/claude-code-vs-cursor.md) - [Configurazione Cursor API](https://runapi.ai/it/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/it/openrouter-alternative.md) - [API x402](https://runapi.ai/it/x402.md) ### Azienda - [Enterprise](https://runapi.ai/it/contact.md) - [Contatti](https://runapi.ai/it/contact.md) ### Legale - [Termini](https://runapi.ai/it/terms.md) - [Privacy](https://runapi.ai/it/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "it", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/it", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/it/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/it", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/iticon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "Article", "headline": "HTTP 402 Payment Required: significato, storia e x402", "description": "Cosa significa il codice di stato HTTP 402 Payment Required, perché è rimasto inutilizzato per decenni, quando le API lo restituiscono oggi e come x402 lo trasforma in un flusso di pagamento.", "datePublished": "2026-09-24", "dateModified": "2026-09-24", "author": { "@type": "Organization", "name": "RunAPI" }, "publisher": { "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/it" }, "mainEntityOfPage": "https://runapi.ai/it/http-402" }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "402 Payment Required è un errore?", "acceptedAnswer": { "@type": "Answer", "text": "È un errore client nell'intervallo 4xx, ma non significa che la richiesta fosse malformata. Significa che serve un pagamento prima che il server continui." } }, { "@type": "Question", "name": "Qual è la differenza tra 402 e 401?", "acceptedAnswer": { "@type": "Answer", "text": "401 significa che il server ha bisogno di credenziali valide. 402 significa che il server ha bisogno di un pagamento. Una API può restituire 401 per una key errata e 402 per una key valida senza saldo." } }, { "@type": "Question", "name": "I browser gestiscono il 402 automaticamente?", "acceptedAnswer": { "@type": "Answer", "text": "No. I browser mostrano un 402 come qualsiasi altra pagina di errore. Il pagamento automatico richiede un client che comprenda un protocollo come x402." } }, { "@type": "Question", "name": "Quali API usano 402 con x402?", "acceptedAnswer": { "@type": "Answer", "text": "Qualsiasi server che implementa il protocollo x402. RunAPI restituisce preventivi x402 sui suoi endpoint di modelli IA a consumo, così un agente può pagare in USDC la generazione di immagini, video, musica e audio." } } ] }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://runapi.ai/it" }, { "@type": "ListItem", "position": 2, "name": "HTTP 402", "item": "https://runapi.ai/it/http-402" } ] } ] ```