# Ketmus

> Ketmus — платёжный шлюз для приёма криптовалюты на сайтах, в интернет-магазинах и Telegram-ботах. REST API: https://app.ketmus.com/api/merchant/v1, авторизация `Authorization: Bearer <API-ключ магазина>`, вебхуки подписаны HMAC-SHA512.

Полная документация одним файлом: https://docs.ketmus.com/llms-full.txt
MCP-сервер документации (Streamable HTTP): https://docs.ketmus.com/mcp

## Правила интеграции

- Покупателя всегда отправляйте на `invoice.pay_url` — платёжную страницу Ketmus. Это касается и кнопок в Telegram-ботах, и редиректов на сайте.
- Не отправляйте покупателю `payment_uri` или `payment.address` вместо `pay_url`. Для СБП (`rail: "sbp_qr"`) там прямая ссылка `https://qr.nspk.ru/…` — с ней покупатель не видит бренд Ketmus, сумму, таймер и статус оплаты и не возвращается в магазин.
- Заказ выдавайте только по вебхуку `invoice.paid` с проверенной подписью `x-ketmus-signature`, а не по возврату покупателя на `success_url`.
- API-ключ и секрет вебхуков храните только на сервере, в переменных окружения.

## Начало работы

- [Обзор документации](https://docs.ketmus.com/md/index.md): Как подключить Ketmus к любому проекту и начать принимать криптовалютные платежи.
- [Как работает интеграция](https://docs.ketmus.com/md/how-it-works.md): Жизненный цикл платежа: от создания счёта до зачисления средств на баланс магазина.
- [Быстрый старт](https://docs.ketmus.com/md/quickstart.md): Первый счёт и обработка оплаты за 10 минут.
- [Получение API-ключа](https://docs.ketmus.com/md/api-keys.md): Где найти API-ключ и секрет вебхуков магазина и как их хранить.
- [Тестирование интеграции](https://docs.ketmus.com/md/testing.md): Как проверить интеграцию перед запуском: тестовый вебхук, проверка подписи и пробный платёж.
- [ИИ-ассистенты и MCP](https://docs.ketmus.com/md/ai.md): Как подключить документацию Ketmus к ChatGPT, Claude, Claude Code, Cursor, VS Code и Codex, чтобы ИИ сам написал интеграцию.

## API Reference v1

- [Авторизация запросов](https://docs.ketmus.com/md/authorization.md): Как передавать API-ключ магазина и какой базовый URL использовать.
- [Ошибки и лимиты](https://docs.ketmus.com/md/errors.md): Формат ошибок API, коды ответов и ограничения на частоту запросов.
- [Создание счёта](https://docs.ketmus.com/md/create-invoice.md): Создаёт счёт на оплату и возвращает ссылку на платёжную страницу и реквизиты.
- [Информация о счёте](https://docs.ketmus.com/md/get-invoice.md): Возвращает счёт с полученными платежами и доступными монетами.
- [Список счетов](https://docs.ketmus.com/md/list-invoices.md): Возвращает счета магазина с фильтром по статусу и постраничной выдачей.
- [Отмена счёта](https://docs.ketmus.com/md/cancel-invoice.md): Отменяет неоплаченный счёт.
- [Статусы счёта](https://docs.ketmus.com/md/invoice-statuses.md): Все статусы счёта, переходы между ними и какие из них окончательные.
- [Статические адреса](https://docs.ketmus.com/md/static-addresses.md): Постоянный адрес пополнения для каждого клиента без создания счетов.
- [Баланс](https://docs.ketmus.com/md/balance.md): Балансы магазина по каждой монете и количество счетов.
- [Монеты и сети](https://docs.ketmus.com/md/rails.md): Список монет и сетей, доступных магазину, с минимальными суммами и подтверждениями.
- [Курсы](https://docs.ketmus.com/md/rates.md): Актуальные курсы криптовалют к USD и фиатным валютам.
- [Информация о магазине](https://docs.ketmus.com/md/store.md): Настройки магазина, к которому относится API-ключ.

## Уведомления

- [Вебхуки](https://docs.ketmus.com/md/webhooks.md): Уведомления об изменении статуса счёта, которые Ketmus отправляет на ваш сервер.
- [Проверка подписи](https://docs.ketmus.com/md/webhook-signature.md): Как убедиться, что вебхук отправлен Ketmus и не был изменён.

## Сценарии интеграции

- [Сайт и интернет-магазин](https://docs.ketmus.com/md/website.md): Подключение оплаты криптовалютой к сайту: кнопка оплаты, платёжная страница и выдача заказа.
- [Telegram-бот](https://docs.ketmus.com/md/telegram-bot.md): Приём криптоплатежей в Telegram-боте и Mini App: подписки, доступ к каналам и цифровые товары.
- [Для бизнеса](https://docs.ketmus.com/md/business.md): Выставление счетов клиентам и партнёрам, ссылки на оплату и сервисы без разработки.
- [Платёжная страница](https://docs.ketmus.com/md/checkout-page.md): Что видит клиент на странице оплаты Ketmus и как настроить возврат на ваш сайт.

## Справочник

- [Поддерживаемые монеты](https://docs.ketmus.com/md/coins.md): Идентификаторы монет и сетей, число подтверждений и минимальные суммы счёта.
- [Поддержка и FAQ](https://docs.ketmus.com/md/faq.md): Ответы на частые вопросы об интеграции Ketmus.