Документация
Документация STONS
Приём криптоплатежей через API и выплаты на адреса из вайтлиста. Приём работает в TRON, в EVM-сетях — Ethereum, BNB Smart Chain, Polygon, Base, Arbitrum, OP Mainnet, Avalanche, — в TON и в Solana; выплаты сервис делает в TRON. Какие активы проект может предложить в данный момент, отвечает GET /v1/assets, а что сервис делает в каждой сети — в документе «Сети и токены». Инвойс в токене отдаёт адрес целиком и точную сумму для оплаты на вашей странице; инвойс без токена оплачивается на странице оплаты сервиса, где покупатель сам выбирает монету и сеть. О событиях сервис сообщает вебхуками с подписью.
Адрес API
https://api.stons.io/v1Для Claude Code и других ИИ-ассистентов
Вставьте эту фразу ассистенту в своём проекте. Он прочитает документацию одним файлом и подключит оплату по шагам, спросив у вас ключи.
Файлы для ИИ-ассистентов
Подключи в этом проекте приём оплаты через STONS. Прочитай документацию https://stons.io/ru/llms-full.txt и выполни по шагам документ «Интеграция под ключ с ИИ-ассистентом»: сначала спроси у меня ключ API, секрет вебхуков и способ показа оплаты, затем реализуй создание инвойса, обработчик вебхуков с проверкой подписи и проверку статуса через API.
Начало
- Интеграция под ключ с ИИ-ассистентомНачните отсюда: словарь, что спросить у владельца проекта, шаги интеграции по порядку с правилами выбора и самопроверка.
- Сети и токеныСети и токены сервиса, что он делает в каждой сети, почему число знаков после запятой зависит от сети и где API сообщает, какие активы может предложить проект.
API
- АутентификацияЗаголовок X-Api-Key и формат ключа, лимиты запросов и Retry-After, ротация ключей и почему клиенту нужен https.
- ИнвойсыСоздание и получение инвойсов: в токене или с выбором токена покупателем, идемпотентность по order_id, статусы, комиссии и суммы строками.
- Адреса для приёма платежейПостоянные адреса пользователей в режиме per_user, два режима адресов и режим на паузе, что зачисляется на адрес, проверка перевода по хэшу транзакции и показ адреса целиком.
- Страница оплатыСтраница оплаты сервиса по checkout_url: что видит покупатель, выбор токена, адреса возврата и подписанный редирект.
- ВебхукиВсе события и когда они приходят, поля тела, проверка подписи HMAC-SHA256 на Node.js и Python и повторы доставки.
- БалансДеньги проекта: баланс каждого актива по реестру, что ещё не подтверждено, и те же деньги в долларах по принятым курсам.
- ВыплатыВыплаты на адреса из вайтлиста: запрос, идемпотентность по reference, статусы, комиссия, лимиты и подтверждение человеком.
- Коды ошибокТело ошибки, каждый error.code с HTTP-статусом и тем, что делать клиенту, и X-Request-Id.