Ваше полное руководство по протоколам HTTP 402 и x402: документация, руководства, whitepapers и ресурсы для разработчиков.
Если вы разработчик, планирующий внедрить API с оплатой за использование, создатель контента, желающий монетизировать свою работу, или разработчик ИИ-агентов, создающий возможности автономных платежей, в этом центре ресурсов есть всё необходимое, чтобы начать работу с x402 и HTTP 402.
Протокол x402 превращает в мощный и практичный платежный механизм статус-код HTTP 402, который долгое время оставался невостребованным. Ниже вы найдёте официальную документацию, примеры кода, руководства по интеграции и ресурсы сообщества, упорядоченные по темам и уровню квалификации.
Впервые слышите о x402? Начните здесь, чтобы понять основы и запустить свою первую интеграцию за считанные минуты.
Подробное введение в протокол x402, включая функции V2, аутентификацию кошелька и мультичейн поддержку.
Глубокий анализ истории статус-кода HTTP 402, его сравнение с другими кодами и причины, по которым он наконец стал полезен.
Пошаговое руководство для пользователей: настройка кошелька, получение USDC и выполнение первого платежа x402.
Авторитетные ресурсы от команды протокола x402 и организаций по веб-стандартам.
Обзор протокола, обновления экосистемы, живые демо и руководства по внедрению. Ваш основной источник новостей и анонсов x402.
Полная техническая спецификация, описывающая дизайн протокола, детали рабочих процессов, соображения безопасности и инструкции по внедрению.
Эталонные реализации с открытым исходным кодом, код SDK, примеры приложений и правила внесения вклада.
Библиотеки и инструменты, которые помогут вам быстро и безопасно интегрировать x402 в ваши приложения.
| Язык | Название пакета | Описание |
|---|---|---|
| Node.js | @x402/server |
Middleware для Express/Fastify для защиты эндпоинтов платежным шлюзом 402. |
| Python | x402-python |
Декораторы для Django/Flask для добавления требований оплаты в ваши представления. |
| Go | x402-go |
HTTP middleware для веб-фреймворков на Go. |
| Rust | x402-rs |
Middleware для Actix/Axum с асинхронной валидацией платежей. |
| Платформа | Название пакета | Описание |
|---|---|---|
| JavaScript/TypeScript | @x402/client |
Клиент для браузера и Node.js для обработки 402 ответов и подписи кошельком. |
| React | @x402/react |
React-хуки и компоненты для платежных сценариев. |
| Python | x402-requests |
Расширение библиотеки Requests с автоматической обработкой 402. |
Пошаговые руководства для распространенных сценариев интеграции.
Узнайте, как добавить оплату за каждый вызов к вашему REST или GraphQL API. Охватывает лимиты запросов, уровни ценообразования и аналитику использования.
Внедрите микроплатежи для статей, видео или загрузок без необходимости подписки.
Позвольте автономным агентам получать доступ к платным ресурсам и совершать платежи без участия человека.
Принимайте платежи в нескольких блокчейнах, включая Ethereum, Base, Polygon и Arbitrum.
Официальная документация по веб-стандартам, касающаяся кодов состояния HTTP и платежных протоколов.
Полный справочник Mozilla Developer Network по статус-коду 402, включая сведения о совместимости браузеров и примечания по использованию.
Официальная спецификация IETF для HTTP, включающая определение 402 как зарезервированного кода состояния.
Исторический контекст, этапы развития кода 402 и краткий обзор попыток его внедрения за многие годы.
Сайт с кратким справочником по всем статус-кодам HTTP с пояснениями и связанными кодами.
Разберитесь в платежном уровне, который обеспечивает транзакции x402.
Официальная документация по USDC — стейблкоину с привязкой к доллару, используемому в платежах x402. Узнайте о резервах, аудитах и поддерживаемых сетях.
Техническая документация для интеграции USDC, включая API-справочники, SDK и лучшие практики.
x402 поддерживает USDC в нескольких сетях для максимальной гибкости.
Структурированные учебные программы в зависимости от вашей роли и целей.
Общайтесь с сообществом x402 и получайте помощь, когда она вам нужна.
Задавайте вопросы, делитесь своими вариантами внедрения и обсуждайте улучшения протокола с сообществом.
Технические вопросы и ответы по проблемам внедрения x402. Используйте тег [x402] для большей
видимости.
Подписывайтесь на @x402protocol для получения анонсов, советов и новостей экосистемы.
Есть вопросы по этой документации? Напишите нам на [email protected].
Узнайте, как x402 соотносится с существующими вариантами интеграции платежей.
| Функция | x402 | Stripe/PayPal | Ручные криптоплатежи |
|---|---|---|---|
| Микроплатежи (менее $1) | ✅ Эффективно | ❌ Высокие комиссии | ⚠️ Переменный газ |
| Аккаунт не требуется | ✅ Только кошелек | ❌ Аккаунт обязателен | ✅ Только кошелек |
| Machine-to-Machine (M2M) | ✅ Нативная поддержка | ❌ Не поддерживается | ⚠️ Сложно |
| Нативно для HTTP | ✅ Статус-код 402 | ❌ Редиректы | ❌ Кастомные сценарии |
| Глобальный доступ | ✅ Без разрешений | ⚠️ Региональные ограничения | ✅ Без разрешений |
| Мгновенные расчеты | ✅ Блокчейн | ❌ Задержка в несколько дней | ✅ Блокчейн |
Ключевые аспекты безопасности при внедрении x402.
Отслеживайте и оптимизируйте внедрение платежей x402.
Да, x402 V2 готов к работе в коммерческих проектах и уже используется в ряде приложений. Протокол поддерживается Coinbase и прошел тщательное тестирование.
Комиссии зависят от используемого блокчейна. В сетях Base и Polygon они составляют доли цента, в то время как в основной сети Ethereum (Mainnet) комиссия может составлять несколько долларов.
В настоящее время x402 ориентирован на USDC из-за простоты и соответствия стандартам. Поддержка мультивалютности включена в план развития.
Возвраты управляются на уровне приложения. Поскольку платежи проходят в блокчейне, вам нужно будет отправить отдельную транзакцию на кошелек пользователя для возврата средств.
x402 — это общедоступный (permissionless) протокол, пользователям не требуется проходить KYC. Однако как у продавца у вас могут быть обязательства по соблюдению нормативных требований в зависимости от вашей юрисдикции.