# STONS: платёжный API

> Приём и выплаты стейблкоинов USDT и USDC в сети TRON. Инвойс отдаёт адрес и точную сумму для оплаты на своей странице и ссылку на готовую страницу оплаты; о событиях сервис сообщает вебхуками с подписью HMAC-SHA256; выплаты — только на адреса из вайтлиста. API: https://api.stons.io/v1, ключ в заголовке X-Api-Key.

Вся документация одним файлом: https://stons.io/llms-full.txt. Описание API в формате OpenAPI 3.1: https://api.stons.io/v1/openapi.json. Интеграцию начинайте с первого документа раздела «Начало».

## Начало

- [Интеграция под ключ с ИИ-ассистентом](https://stons.io/docs/ai-integration.md): Этот документ — задание для ИИ-ассистента в проекте мерчанта: Claude Code, Cursor или любого другого, который пишет код по инструкции.

## API

- [Аутентификация](https://stons.io/docs/authentication.md): Каждый запрос к маршрутам /v1 передаёт ключ API мерчанта в заголовке X-Api-Key:
- [Инвойсы](https://stons.io/docs/invoices.md): Инвойс — ожидание платежа на конкретную сумму в конкретном активе до дедлайна.
- [Страница оплаты](https://stons.io/docs/checkout.md): Кроме интеграции, в которой продукт сам показывает покупателю адрес и сумму, сервис умеет принимать платёж на своей странице.
- [Вебхуки](https://stons.io/docs/webhooks.md): Сервис сообщает мерчанту о событиях — платёж замечен, платёж подтверждён, инвойс просрочен — запросом POST на его URL.
- [Адреса для приёма платежей](https://stons.io/docs/addresses.md)
- [Выплаты](https://stons.io/docs/payouts.md): Выплата — перевод средств мерчанта на адрес, который заранее внесён в его вайтлист.
- [Коды ошибок](https://stons.io/docs/errors.md): Любой ответ API с кодом 4xx или 5xx имеет одно и то же тело:

## Перед запуском

- [Чек-лист перед продом](https://stons.io/docs/checklist.md): Пройдите его, прежде чем принимать реальные платежи.

## Optional

- [Журнал изменений API](https://stons.io/docs/changelog.md): Все изменения публичного API: новые маршруты, поля, события вебхуков и коды ошибок.