Что такое x402.
x402 это открытый протокол для HTTP-нативных платежей, опубликованный Coinbase в конце 2024 года. Он определяет, как сервер возвращает 402 Payment Required с структурированным телом JSON - список приемлемых требований к платежам (схема, сеть, идентификатор цепи, адрес получателя, сумма в базовых единицах USDC и идентификатор запроса на платеж) - так что клиент машина может разобрать ответ, оплатить в цепочке и повторить исходный вызов с заголовком X-Payment, все программно.
HTTP 402 оставался неиспользованным тридцать лет. x402 заставил его работать.
The 402 Payment Required status code was reserved in the original HTTP spec for "future use" and never received a standardized implementation. For three decades, every actual payment flow on the web was built on top of 200 / 401 / 403: a server returns 401 when authentication is missing, the client signs up via a separate UI flow, gets credentials, and re-authenticates. The signup happens out of band. None of this works for AI agents, which cannot complete signup forms.
x402 fixes this by giving 402 a usable specification. A server can return 402 with structured machine-readable payment instructions; a client can parse those instructions, pay, and retry, all without ever touching a signup form. The protocol is the missing piece between "AI agents can call APIs" and "AI agents can pay for the APIs they call". Before x402, the only practical agent payment paths were pre-paid balance accounts (with manual top-up) or proprietary integrations per API. Both broke at scale.
Стратегическое значение x402 заключается в том, что он устанавливает стандарт, на который может опираться остальная часть экосистемы. Кошельки реализуют обработчик x402 один раз, и каждый API, совместимый с x402, работает с этим кошельком. Серверные фреймворки реализуют промежуточное ПО x402 один раз, и каждый клиент, осведомленный о x402, может им платить. Фасилитаторы (сервисы, которые осуществляют расчеты по основным платежам) конкурируют по качеству обслуживания, а не по привязке.
Один ответ, одна повторная попытка, один платеж.
Жизненный цикл имеет три состояния: неоплаченный вызов, платеж, повторный вызов. Ниже показано, как на самом деле выглядит ответ на неоплаченный вызов по сети.
HTTP/1.1 402 Payment Required Content-Type: application/json { "resource": "POST /api/research-query", "accepts": [ { "scheme": "exact-usdc", "network": "mainnet", "chainId": "eip155:8453", "payToAddress": "0xAgent...", "amountWeiUsdc": "50000", "paymentRequestId": "pr_01J9...", "maxAgeSeconds": 60 } ] }
- Status code 402. Distinct from 401 (auth missing) and 403 (auth refused). The presence of 402 signals "payment is the missing input."
- resource + accepts[]. Тело называет защищенный ресурс и перечисляет одно или несколько приемлемых требований к оплате. Миграция может ссылаться на два требования (например, основная сеть и тестовая сеть) и позволить клиенту выбрать.
- scheme / network / chainId. Схема оплаты (exact-usdc), цепочка (основная сеть - Base) и ее CAIP-2 идентификатор. Клиент сопоставляет это перед оплатой.
- payToAddress / amountWeiUsdc. Кошелек получателя и точная сумма в базовых единицах USDC (50000 = 0.05 USDC, 6 десятичных знаков). Клиент проверяет оба перед оплатой.
- paymentRequestId + maxAgeSeconds. Идентификатор связывает оплату с этой котировкой; maxAgeSeconds - насколько свежей должна быть оплата. Оплата, которая ссылается на другой идентификатор или старше окна, отклоняется.
- Повторная попытка включает заголовок X-Payment. Клиент оплачивает в цепочке, затем повторно выдает исходный запрос с заголовком X-Payment, подтверждающим оплату. Сервер проверяет это и возвращает реальный результат. Никакие заголовки ответа или хостинговая страница не являются частью самой проводки x402.
x402 в дикой природе.
Три конкретных развертывания, упорядоченные по тому, насколько зрелым является принятие в каждом слое.
Сервер MCP возвращает 402 вызов для неоплаченного инструмента
Платный инструмент MCP получает вызов от Claude Desktop, и вызывающий еще не отмечен как оплаченный. Сервер создает вызов requirePayment - 402, тело которого содержит цену и hostedUrl - и возвращает его как ошибку инструмента. Claude Desktop отображает ссылку в чате; пользователь платит $0.05 USDC; следующий вызов того же инструмента проходит успешно.
Биллинг за вызов с ограничением конечной точки API
API для исследований взимает $0.50 за вызов через адаптер сервера x402. AI-агент вызывает конечную точку, получает 402 с указанием суммы и получателя, платит на Base из своего кошелька и повторно выдает запрос с заголовком X-Payment. Адаптер проверяет заголовок и возвращает оплаченный ответ. Весь цикл завершается за менее чем 60 секунд.
Агент, оплачивающий программно через кошелек, осведомленный о x402
Время выполнения агента осведомлено о x402 (оно реализует спецификацию). Когда он сталкивается с 402, он считывает payToAddress и сумму из accepts[], подписывает перевод со своего предварительно авторизованного кошелька (в пределах его разрешения на расходы), транслирует на Base и повторяет оригинальный вызов с заголовком X-Payment. Без участия человека; цикл завершается за 5-10 секунд.
Что окружает x402 в стеке.
x402 - это протокол. Эти три термина охватывают концепции, на которых он основан, и случаи использования, которые он позволяет.