RU

Оплата x402 API из Solana, Stellar, BNB Chain и других сетей

Shawn Muggle

Идея x402 простая. Сервер отвечает на запрос кодом 402 Payment Required, перечисляет, что принимает, а клиент платит и отправляет запрос снова. Без аккаунта, без счёта, без формы карты. Для AI агентов, которые вызывают много небольших платных API, это почти идеально.

Есть одна загвоздка. Способ оплаты выбирает эндпоинт, и x402 эндпоинты, с которыми сталкивается агент, обычно просят USDC в конкретной сети, например Base или Solana. А у агента может быть что-то другое: USDT в Solana, USDC в Stellar или USDT в BNB Chain. Делать бридж перед каждым вызовом тоже не выйдет: платёжное требование x402 действует всего несколько минут, а перевод между сетями обычно занимает больше времени.

ROZO независима и не связана ни с одним продавцом x402.

Пополните один раз, платите много раз

x402 payer от ROZO делит задачу на две части. Вы один раз пополняете баланс ROZO той монетой, что у вас уже есть, в той сети, которой вы уже пользуетесь. После этого каждый вызов x402 к эндпоинту, который принимает USDC в Base, оплачивается с этого баланса за секунды, в пределах платёжного окна.

Если ваш агент умеет запускать команды в shell, вот вся интеграция:

  1. Пополните баланс один раз. Команда выводит одноразовый адрес для депозита; оплатите его со своего кошелька: npx @rozoai/checkout x402 topup 20 --with usdt-solana
  2. Вызовите платный эндпоинт. CLI читает 402, ROZO подписывает, и запрос отправляется снова с оплатой: npx @rozoai/checkout x402 pay https://api.example.com/v1/search --method POST --body '{"q":"..."}'
  3. Посмотрите остаток: npx @rozoai/checkout x402 balance

Что происходит при x402 pay

Ваша машина отправляет запрос прямо на эндпоинт. Когда приходит 402, CLI читает платёжные требования, оставляет только вариант с USDC в Base и просит ROZO подписать этот один платёж. Затем повторяет ваш исходный запрос с заголовком PAYMENT-SIGNATURE и выводит ответ.

У каждого платежа есть idempotencyKey, и повтор этого платежа использует тот же ключ, поэтому таймаут не может списать деньги дважды.

Нет shell? Тот же платёж работает через два основных HTTP эндпоинта, /v1/x402/topup и /v1/x402/sign, с ключом агента в качестве bearer token. Агент сам повторяет свой запрос с подписью. Оба вызова показаны на странице x402.

Что защищает ваши деньги

Дать агенту кошелёк по-настоящему рискованно, поэтому payer построен на узких правах.

Чем можно пополнить и что получает продавец

Здесь две части, и мы специально показываем их отдельно.

Пополнение, от вас к ROZO:

Есть нативная монета или sats? Их можно использовать, чтобы пополнить OpenRouter через ROZO Checkout на checkout.rozo.ai.

Оплата, от ROZO продавцу x402:

Продавцы всегда получают USDC, потому что платежи x402 exact являются переводами токенов. USDT только пополняет баланс, продавец получает USDC. Если эндпоинт принимает только USDC в Solana, CLI останавливается с X402_UNSUPPORTED до какого-либо списания.

Минимальное пополнение $5, комиссия за пополнение 1%. Каждый платёж x402 с баланса стоит ровно столько, сколько просит продавец. Самостоятельный вывод пока недоступен: напишите на hi@rozo.ai, укажите замаскированный ключ и сумму, и баланс вернут в выбранной вами сети.

Начните сейчас

Payer уже работает. На странице checkout.rozo.ai/x402 собраны три команды, HTTP вызовы, лимиты и FAQ. Полный справочник со всеми кодами ошибок находится на docs.rozo.ai. Агенты могут прочитать те же инструкции, с правилами безопасности и советами по повторам, в checkout.rozo.ai/llms.txt и в репозитории RozoAI/rozo-checkout-skill на GitHub.

Пополните баланс один раз той монетой, что у вас есть, и пусть агент сам платит за API, которые вызывает.

Частые вопросы

Зачем пополнять баланс перед оплатой x402 API?
Платёжное требование x402 действует всего несколько минут, а перевод между сетями обычно занимает больше. Оплата с уже готового баланса позволяет уложиться в это окно. Пополняете редко и крупными суммами, платите часто и понемногу.
В каких сетях продавец x402 может получить оплату?
USDC в Base (eip155:8453), схема x402 exact. Оплата в Solana появится позже. Если эндпоинт принимает только Solana, CLI останавливается с X402_UNSUPPORTED и ничего не списывается.
Это подписка?
Нет. Каждому вызову нужен новый 402 от продавца и новая подпись от ROZO, поэтому продавец никогда не получает постоянного разрешения списать с вас деньги снова.
Какие лимиты и комиссии?
По умолчанию $5 за платёж и $100 на ключ в день, настраивается для каждого ключа. Минимальное пополнение $5 с комиссией 1% за пополнение; каждый платёж x402 стоит ровно столько, сколько просит продавец.
Как вернуть баланс?
Самостоятельный вывод пока недоступен. Напишите на hi@rozo.ai, укажите замаскированный ключ и сумму, и баланс вернут в выбранной вами сети.

Оплачивайте x402 API той монетой, которая у вас есть

Один раз пополните баланс ROZO в USDT или USDC в той сети, которой вы уже пользуетесь. Затем агент оплачивает с этого баланса x402 эндпоинты, которые принимают USDC в сети Base.

Открыть x402 payer

Оплачивайте x402 API той монетой, которая у вас есть

Открыть x402 payer