--- title: 'HTTP 402 Payment Required: znaczenie, historia i x402 | RunAPI' description: Co oznacza kod stanu HTTP 402 Payment Required, dlaczego przez dekady był nieużywany, kiedy API zwracają go dziś i jak x402 zamienia go w proces płatności. url: https://runapi.ai/pl/http-402.md canonical: https://runapi.ai/pl/http-402 locale: pl 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/pl/http-402 > Site index for agents: https://runapi.ai/llms.txt # HTTP 402 Payment Required: co oznacza i jak wykorzystuje go x402 402 to kod stanu HTTP dla żądania, które wymaga płatności, zanim serwer je zrealizuje. Przez większą część swojej historii nie miał standardowego formatu. x402 mu go nadaje. _Zaktualizowano September 24, 2026 · 5 min czytania_ ## Key takeaways - 402 Payment Required to błąd po stronie klienta: żądanie jest poprawne, ale serwer najpierw chce zapłaty. - HTTP/1.1 zarezerwował kod 402 do przyszłego użytku i nigdy nie zdefiniował, jak ma działać płatność, więc każde API stosowało go inaczej. - x402 definiuje brakujące elementy: nagłówek PAYMENT-REQUIRED z warunkami czytelnymi dla maszyn i podpisaną płatność przy ponowieniu żądania. ## Co oznacza 402 Payment Required Odpowiedź 402 mówi klientowi, że samo żądanie jest w porządku, ale nie zostanie zrealizowane, dopóki nie nastąpi płatność. Należy do rodziny 4xx, ponieważ kolejny krok musi wykonać klient, a nie serwer. 402 różni się od 401 Unauthorized i 403 Forbidden. 401 wymaga danych uwierzytelniających, 403 wprost odrzuca żądanie, a 402 wymaga płatności. ## Dlaczego 402 był nieużywany tak długo Kod zarezerwowano w chwili powstawania HTTP/1.1, zakładając, że w przyszłości pojawi się jakaś forma cyfrowej gotówki. Specyfikacja nigdy nie określiła, co ma zawierać treść odpowiedzi 402 ani jak klient ma zapłacić, więc przeglądarki nigdy na nią nie reagowały. Bez wspólnego formatu API, które faktycznie zwracały 402, traktowały go jako zwykły błąd: skończyły się kredyty na koncie, karta została odrzucona lub osiągnięto limit planu. ## Kiedy API zwracają dziś 402 Kod 402 pojawia się w dwóch głównych sytuacjach. - Błędy rozliczeniowe konta: klucz jest ważny, ale saldo, limit lub subskrypcja nie pokrywają żądania. Rozwiązaniem jest doładowanie lub podwyższenie planu. - Wyceny płatne za żądanie: serwer zwraca warunki płatności, a klient może zapłacić i ponowić to samo żądanie. Tak właśnie działa x402. ## Jak x402 zamienia 402 w proces płatności x402 umieszcza warunki czytelne dla maszyn w nagłówku PAYMENT-REQUIRED: kwotę, aktywo, sieć i odbiorcę. Klient podpisuje autoryzację stablecoina zgodną z tymi warunkami, odsyła ją w nagłówku PAYMENT-SIGNATURE i otrzymuje odpowiedź z potwierdzeniem PAYMENT-RESPONSE. Ponieważ cała wymiana odbywa się w zwykłym HTTP, agent AI z portfelem może zapłacić za wywołanie API bez rejestracji i bez przechowywania klucza API. ## Obsługa 402 w swoim kliencie Najpierw sprawdź, czy jest nagłówek PAYMENT-REQUIRED. Jeśli tak, odpowiedź to wycena x402 i klient x402 może ją opłacić. Jeśli go nie ma, odczytaj treść błędu: zwykle oznacza to, że konto potrzebuje więcej kredytów lub innego planu. ## FAQ o HTTP 402 ### Czy 402 Payment Required to błąd? To błąd po stronie klienta z zakresu 4xx, ale nie oznacza, że żądanie było źle sformułowane. Oznacza, że przed kontynuacją przez serwer potrzebna jest płatność. ### Jaka jest różnica między 402 a 401? 401 oznacza, że serwer potrzebuje ważnych danych uwierzytelniających. 402 oznacza, że serwer potrzebuje płatności. API może zwrócić 401 przy błędnym kluczu i 402 przy ważnym kluczu bez środków. ### Czy przeglądarki obsługują 402 automatycznie? Nie. Przeglądarki pokazują 402 jak każdą inną stronę błędu. Automatyczna płatność wymaga klienta, który rozumie protokół taki jak x402. ### Które API używają 402 razem z x402? Każdy serwer, który implementuje protokół x402. RunAPI zwraca wyceny x402 na swoich endpointach modeli AI rozliczanych za wywołanie, dzięki czemu agent może zapłacić w USDC za generowanie obrazu, wideo, muzyki i audio. ## Powiązane strony - [API x402 dla modeli AI](https://runapi.ai/pl/x402.md) - Płatność za żądanie w USDC na Base bez klucza API. - [Katalog modeli](https://runapi.ai/pl/models.md) - Wszystkie modele i endpointy dostępne w RunAPI. - [Dokumentacja dla programistów](https://runapi.ai/pl/docs/guides) - Formaty żądań, sprawdzanie stanu zadań i kody błędów. - [Cennik](https://runapi.ai/pl/pricing.md) - Kredyty, ceny za wywołanie i szczegóły rozliczeń. Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only. ## Wypróbuj kod 402, który faktycznie możesz opłacić Wyślij żądanie do endpointu RunAPI rozliczanego za wywołanie bez klucza i sprawdź zwróconą wycenę x402. - [Przeglądaj modele](https://runapi.ai/pl/models.md) - [Czytaj dokumentację](https://runapi.ai/pl/docs/guides) --- ## More from RunAPI - [Home](https://runapi.ai/pl/.md) ### Produkt - [Katalog modeli](https://runapi.ai/pl/models.md) - [Cennik](https://runapi.ai/pl/pricing.md) - [Dostawcy](https://runapi.ai/pl/models#all-models) ### Dla developerów - [Dokumentacja](https://runapi.ai/pl/docs/guides) - [SDK](https://runapi.ai/pl/sdk.md) - [CLI](https://runapi.ai/pl/cli.md) - [Serwer MCP](https://runapi.ai/pl/mcp.md) ### Przewodniki - [Claude Code vs Cursor](https://runapi.ai/pl/claude-code-vs-cursor.md) - [Konfiguracja Cursor API](https://runapi.ai/pl/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/pl/openrouter-alternative.md) - [API x402](https://runapi.ai/pl/x402.md) ### Firma - [Enterprise](https://runapi.ai/pl/contact.md) - [Kontakt](https://runapi.ai/pl/contact.md) ### Prawne - [Regulamin](https://runapi.ai/pl/terms.md) - [Prywatność](https://runapi.ai/pl/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "pl", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/pl", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/pl/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "pl", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pl", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/plicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "pl", "@type": "Article", "headline": "HTTP 402 Payment Required: znaczenie, historia i x402", "description": "Co oznacza kod stanu HTTP 402 Payment Required, dlaczego przez dekady był nieużywany, kiedy API zwracają go dziś i jak x402 zamienia go w proces płatności.", "datePublished": "2026-09-24", "dateModified": "2026-09-24", "author": { "@type": "Organization", "name": "RunAPI" }, "publisher": { "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pl" }, "mainEntityOfPage": "https://runapi.ai/pl/http-402" }, { "@context": "https://schema.org", "inLanguage": "pl", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Czy 402 Payment Required to błąd?", "acceptedAnswer": { "@type": "Answer", "text": "To błąd po stronie klienta z zakresu 4xx, ale nie oznacza, że żądanie było źle sformułowane. Oznacza, że przed kontynuacją przez serwer potrzebna jest płatność." } }, { "@type": "Question", "name": "Jaka jest różnica między 402 a 401?", "acceptedAnswer": { "@type": "Answer", "text": "401 oznacza, że serwer potrzebuje ważnych danych uwierzytelniających. 402 oznacza, że serwer potrzebuje płatności. API może zwrócić 401 przy błędnym kluczu i 402 przy ważnym kluczu bez środków." } }, { "@type": "Question", "name": "Czy przeglądarki obsługują 402 automatycznie?", "acceptedAnswer": { "@type": "Answer", "text": "Nie. Przeglądarki pokazują 402 jak każdą inną stronę błędu. Automatyczna płatność wymaga klienta, który rozumie protokół taki jak x402." } }, { "@type": "Question", "name": "Które API używają 402 razem z x402?", "acceptedAnswer": { "@type": "Answer", "text": "Każdy serwer, który implementuje protokół x402. RunAPI zwraca wyceny x402 na swoich endpointach modeli AI rozliczanych za wywołanie, dzięki czemu agent może zapłacić w USDC za generowanie obrazu, wideo, muzyki i audio." } } ] }, { "@context": "https://schema.org", "inLanguage": "pl", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Strona główna", "item": "https://runapi.ai/pl" }, { "@type": "ListItem", "position": 2, "name": "HTTP 402", "item": "https://runapi.ai/pl/http-402" } ] } ] ```