← Создание агентов на Cloudflare / agents / tools / payments

x402

x402 ↗ это платёжный стандарт, построенный вокруг HTTP 402 (Payment Required). Сервисы возвращают ответ 402 с инструкциями по оплате, а клиенты платят программно, без учётных записей, сессий или ключей API.

Как это работает

Клиент запрашивает ресурс: GET /resource.
Сервер возвращает 402 Payment Required с PAYMENT-REQUIRED заголовок, содержащий закодированные в Base64 платёжные данные: цену, принимаемый токен, сеть и адрес продавца.
Клиент формирует подписанный платёжный payload и повторяет запрос с PAYMENT-SIGNATURE заголовок.
Сервер проверяет платёжный payload: напрямую или обращаясь к фасилитатор : и фиксирует транзакцию в блокчейне.
Сервер возвращает ресурс с PAYMENT-RESPONSE заголовок, содержащий подтверждение расчёта.

Основные компоненты

Клиент

Клиентом может быть любой субъект, запрашивающий платный ресурс: приложение, управляемое человеком, ИИ-агент или программный сервис. Клиенту нужен лишь криптокошелёк, без учётных записей, учётных данных и сессионных токенов.

Сервер

Сервер определяет требования к оплате в 402 ответ, проверяет входящие данные платежа, завершает транзакцию и отдаёт ресурс. SDK x402 и facilitator берут на себя большую часть этой работы автоматически.

Фасилитатор

Фасилитатор представляет собой необязательный, но рекомендуемый сторонний сервис, который абстрагирует взаимодействие с блокчейном. Вместо прямого подключения к узлу сервер делегирует ему две операции:

POST /verify : Подтверждает, что полезная нагрузка платежа клиента действительна, прежде чем сервер выполнит запрос.
POST /settle : отправляет проверенную платёжную транзакцию в блокчейн.

Фасилитатор не хранит средства. Он проверяет предварительно подписанную транзакцию клиента и рассылает её в сеть от имени сервера. https://x402.org/facilitator это публичный фасилитатор, которым управляет Coinbase, и он используется во всех примерах Cloudflare. Несколько фасилитаторов ↗ доступны в разных сетях.

Платёжные схемы и сети

x402 использует платёжные схемы чтобы определить, как платёж формируется и проводится в заданной сети.

Scheme	Сети	Описание
`exact` ↗	EVM, Solana, Aptos, Stellar, Hedera, Sui	Переводит фиксированную сумму токенов, обычно ERC-20 ↗ USDC в сети EVM на адрес продавца.
`upto` ↗	EVM	Авторизует максимальную сумму; фактическая сумма списания определяется в момент расчёта на основе потреблённых ресурсов.

Поддерживаемые сети: Base, Ethereum, Polygon, Optimism, Arbitrum, Avalanche, Solana, Aptos, Stellar и Sui. Используйте base-sepolia для тестирования с бесплатными тестовыми USDC из Circle Faucet ↗.

Плата за ресурсы

HTTP-контент

Ограничивайте доступ к API, веб-страницам и файлам через прокси Worker

MCP-инструменты

Плата за вызов инструмента с помощью paidTool

Оплата ресурсов

Agents SDK

Оберните MCP-клиенты с помощью withX402Client

Инструменты для написания кода

Плагин OpenCode и хук Claude Code

SDK

Пакет	Установить	Использование
`x402-hono`	`npm install x402-hono`	Hono middleware для серверов Worker
`@x402/fetch`	`npm install @x402/fetch`	Обёртка fetch с автоматической обработкой платежей
`@x402/evm`	`npm install @x402/evm`	Поддержка платёжной схемы EVM
`agents/x402`	Включено в `agents`	MCP-клиент с поддержкой платежей x402

x402.org ↗ : спецификация протокола
x402 на GitHub ↗ : SDK с открытым исходным кодом
примеры x402 ↗ : Полный рабочий код
Pay Per Crawl : Нативная для Cloudflare монетизация