Перейти к содержанию
STONS

USDT и USDC · сеть TRON

Принимайте USDT и USDC. Каждый шаг платежа — на виду.

Счёт через API или вручную в кабинете, готовая страница оплаты с возвратом на ваш сайт и вебхуки с подписью HMAC-SHA256. Документацию целиком прочитает и ваш ИИ-ассистент.

Регистрация открытая, платежи — после проверки проекта.

Путь платежа

От счёта до возврата на ваш сайт

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

  1. Счёт

    POST /v1/invoices

    Счёт создаётся через POST /v1/invoices или вручную в кабинете. В ответе — адрес целиком, сумма к оплате и ссылка на страницу оплаты.

    Подробнее: Счёт
  2. Оплата

    checkout_url

    Покупатель видит сумму к оплате с тикером и сетью, QR-код, адрес целиком и время до срока, а статус обновляется сам.

    Подробнее: Оплата
  3. Подтверждения

    20 блоков

    Перевод виден через несколько секунд, подтверждение в TRON — 20 блоков, около минуты.

    Подробнее: Подтверждения
  4. Вебхук

    invoice.confirmed

    invoice.confirmed приходит на ваш адрес. Не ответили 2xx за 10 секунд — повтор через 10 секунд, 1 минуту, 5 минут, 30 минут, 2 часа и 6 часов.

    Подробнее: Вебхук
  5. Возврат на сайт

    return_url

    Страница оплаты возвращает покупателя на ваш сайт подписанным редиректом, а товар вы отдаёте по ответу API.

    Подробнее: Возврат на сайт

Способы

Интеграция, готовая страница или счёт вручную

API и вебхуки

Ключ — в заголовке X-Api-Key, описание API — GET /v1/openapi.json в формате OpenAPI 3.1.

curl https://api.stons.io/v1/invoices \
  -H "X-Api-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_id": "ord_1001", "asset": "USDT_TRON",
       "amount": "49.9", "expires_in": 3600}'
  • order_id — ключ идемпотентности: повтор запроса вернёт тот же счёт.
  • Суммы — строки в единицах актива: в числе с плавающей точкой копейки теряются.
  • Вебхуки подписаны HMAC-SHA256: проверьте подпись и возьмите состояние из API.
  • Ключ API показывается один раз, а сервис хранит только хэш его секрета.

Страница оплаты

Отправьте покупателя по checkout_url из ответа: страница покажет, сколько и куда платить, и сама будет следить за статусом.

  • Покупатель видит сумму к оплате с тикером и сетью, QR-код, адрес целиком и время до срока, а статус обновляется сам.
  • QR-код содержит только адрес, поэтому сумма показывается и копируется отдельно.
  • Страница оплаты возвращает покупателя на ваш сайт подписанным редиректом, а товар вы отдаёте по ответу API.

Счёт вручную в кабинете

Без интеграции: токен, сумма, назначение и срок — и счёт готов. Повторное нажатие с той же формой вернёт тот же счёт.

  • Адрес вебхуков для счетов вручную не обязателен: они оплачиваются и зачисляются как обычно.
  • Кабинет показывает только проекты своей учётной записи: владение проверяет само ядро, на каждом запросе.

Активы

USDT и USDC в сети TRON

Адреса контрактов прочитаны в сети, а не взяты из статей.

  • USDTTRON · TRC20
    USDT_TRON
    Контракт
    TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
    Подтверждений
    20
    Операции
    приём и выплаты
  • USDCTRON · TRC20
    USDC_TRON
    Контракт
    TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8
    Подтверждений
    20
    Операции
    приём и выплаты

Отправлять нужно ровно этот актив и в этой сети. TRX платежом пока не считается.

Подключение

Проект проверяют до первого платежа

Ключи API можно выпустить сразу и готовить интеграцию, пока идёт проверка.

Подключиться
  1. 01Регистрация

    Почта, имя и пароль от 12 символов.

  2. 02Второй фактор

    Приложение-аутентификатор обязательно — на каждом входе.

  3. 03Заявка на проект

    Сайт проекта и что продаёт бизнес — своими словами.

  4. 04Проверка

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

Для ИИ-ассистентов

Интеграцию подключит ваш ИИ-ассистент

Отдайте одну фразу Claude Code или другому ассистенту в своём проекте: он прочитает документацию одним файлом и подключит оплату по шагам.

/llms.txt — указатель по формату llms.txt, /llms-full.txt — вся документация одним файлом, Markdown любой страницы — по её адресу с .md.

Фраза для ИИ-ассистента

Подключи в этом проекте приём оплаты через STONS. Прочитай документацию https://stons.io/llms-full.txt и выполни по шагам документ «Интеграция под ключ с ИИ-ассистентом»: сначала спроси у меня ключ API, секрет вебхуков и способ показа оплаты, затем реализуй создание инвойса, обработчик вебхуков с проверкой подписи и проверку статуса через API.

Вся документация

Устройство

Как устроены деньги

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

Заведите проект и готовьте интеграцию, пока его проверяют

Регистрация открытая, платежи — после проверки проекта.