Позвольте AI-агентам платить через OKXи регистрироваться самим
Платите через OKX Wallet по x402 и получайте API key и баланс одним запросом.
- USD₮0 в X Layer, расчёт через OKX
- Без банковской карты и формы регистрации
- Обычные пользователи тоже могут пополнять баланс через x402
curl -i -X POST https://bazaarlink.ai/api/v1/agents/register/x402 \
-H "Content-Type: application/json" \
-d '{"name":"my-agent","amountUsd":1.1}'HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"x402Version": 2,
"resource": {
"url": "https://bazaarlink.ai/api/v1/agents/register/x402",
"description": "BazaarLink paid agent registration",
"mimeType": "application/json"
},
"accepts": [
{
"scheme": "exact",
"network": "eip155:196",
"payTo": "0xPAY_TO_ADDRESS",
"asset": "0xASSET_CONTRACT",
"amount": "1100000",
"maxTimeoutSeconds": 300,
"extra": { "name": "USD₮0", "version": "1" }
}
]
}Что такое x402
- POST
/api/v1/agents/register/x402 - ← 402
accepts[ network, asset, amount, payTo ] - sign
EIP-3009 - POST
X-PAYMENT: … - ← 201
api_key, credits, claim_token
Платежи проходят через x402 facilitator OKX в X Layer on-chain; сервер проверяет каждый из них до выполнения действия.
HTTP 402 запрашивает оплату
Сервер отвечает кодом 402 и указывает принимаемые сеть, актив, сумму и адрес получателя. Клиент подписывает платёжное разрешение и отправляет тот же запрос повторно. BazaarLink проводит каждый платёж через x402 facilitator OKX в X Layer.
api_keysk-bl-…credits5claim_token…payment.txHash0x…Аккаунт заранее не нужен
Агенту не нужно заранее заполнять форму или создавать аккаунт. Запрос с платежом создаёт аккаунт, выдаёт API key и добавляет баланс.
Четыре шага от запроса до API key
Отправьте запрос
Выполните POST на /api/v1/agents/register/x402, указав имя и сумму в долларах США.
Получите 402
Сервер ответит кодом 402 и условиями платежа. На этом этапе ничего не создаётся.
Подпишите и отправьте снова
Подпишите платёжное разрешение собственным кошельком, поместите его в заголовок X-PAYMENT и повторно отправьте тот же запрос.
Получите API key
После подтверждения платежа вы получите ответ 201 с API key, балансом и ссылкой для передачи аккаунта. API key показывается только в этом ответе — сохраните его сразу.
Уже есть аккаунт? Пополняйте баланс через x402
Агент использует имеющийся API key. Обычный пользователь входит в аккаунт и пополняет баланс на странице кредитов.
Агенты и скрипты
Выполните POST на /api/x402/topup с заголовком Authorization и параметром amountUsd. Процесс тот же: запрос, подпись, повторная отправка.
Обычные пользователи
Войдите, откройте страницу кредитов, выберите x402 и подпишите платёж в браузерном кошельке.
Поддерживаемая сеть и актив
Сейчас поддерживается одна комбинация.
- Сеть
- X Layer, расчёт через x402 facilitator OKX
- Актив
- USD₮0
- Баланс
- Взимается комиссия платформы за пополнение, поэтому зачисленный баланс меньше уплаченной суммы (см. цены)
- Сумма платежа
- Есть минимальная и максимальная сумма; текущие ограничения указаны в ответе 402 и в GET /api/x402/topup
Платежи on-chain нельзя отменить. Перед подписью проверьте сумму и сеть.
Ещё не платили? Бесплатные модели работают
Неоплаченный аккаунт агента использует доступную квоту бесплатных моделей и ограничения частоты (auto:free). После оплаты аккаунт работает по обычным правилам платных аккаунтов.
Частые вопросы
Что такое x402?
x402 — это протокол, который использует код HTTP 402 для запроса оплаты. Сервер сообщает сумму, сеть и адрес получателя; клиент подписывает платёжное разрешение и отправляет тот же запрос снова.
Что нужно для оплаты через x402?
OKX Wallet или ключ любого кошелька, который может подписать разрешение EIP-3009, а также USD₮0 в X Layer. В документации интеграции есть код TypeScript, использующий клиент x402 для подписи.
Какие сеть и актив поддерживаются?
USD₮0 в X Layer, расчёт через x402 facilitator OKX. Взимается комиссия платформы за пополнение, поэтому полученный баланс меньше уплаченной суммы; см. страницу цен.
Что будет при повторной оплате или отправке?
Каждый платёж зачисляется один раз. Повторная отправка того же платежа при пополнении вернёт already_credited. При регистрации одинаковый результат возвращается 15 минут; затем возвращается already_registered, а API key больше не показывается.
Можно ли получить возврат?
Платежи on-chain нельзя отменить, и система не возвращает деньги автоматически. Если что-то пошло не так, обратитесь в поддержку.
Есть ли ограничение на регистрации?
Да. Регистрации из одного сетевого источника ограничены на короткий период. При достижении лимита вы получите 429 с заголовком Retry-After; подождите и повторите попытку.
Может ли человек забрать аккаунт агента?
Да. Ответ регистрации содержит claim_token и upgrade_url. Человек входит в аккаунт и забирает его, после чего API key и баланс переходят в этот аккаунт. claim_expires указывает срок действия.