# Платёжный API / Payment API

> Документация для мерчантов: приём платежей по СБП и по карте, подпись запросов RFC 9421 (Ed25519), callback-и с HMAC-SHA256. / Merchant docs: SBP and card payments, RFC 9421 (Ed25519) request signing, HMAC-SHA256 callbacks.

Каждая страница доступна в Markdown: добавьте .md к адресу. Адрес API в примерах — {{base_url}}: его выдают мерчанту отдельно для песочницы и боевого окружения. / In examples the API address is {{base_url}}: it is issued to the merchant, separately for the sandbox and production. MCP-сервер документации (на этом же хосте) / Docs MCP server (same host): /mcp. Полный текст / Full text: /llms-full.txt.

## Документация на русском

- [Обзор](/index.md): Что такое платёжный API, интеграция за пять шагов, окружения и общие правила API.
- [Быстрый старт](/quickstart.md): От настройки кабинета до первой подписанной заявки по СБП и приёма callback-ов примерно за 15 минут.
- [Песочница](/sandbox.md): Тестовое окружение API — адреса, тестовый проект, тестовые реквизиты, как задать исход заявки и узнать результат.
- [Приём по СБП](/sbp.md): Создание заявки на приём по СБП, поля запроса и ответа, расчёт в USDT, что показать плательщику, статусы, опрос и callback-и, крайние случаи.
- [Приём по карте](/card.md): Заявка на перевод на карту (card_transfer), чем она отличается от СБП, что показать плательщику и крайние случаи.
- [Статусы и ошибки](/statuses.md): Статусы заявки, коды error_code, HTTP-ошибки API и когда повторять запрос.
- [Идемпотентность и лимиты](/idempotency.md): Как безопасно повторять создание заявки по merchant_payment_id, nonce и лимиты запросов проекта.
- [Подпись запросов](/signing.md): Профиль подписи RFC 9421 с Ed25519, построение базы подписи, общий проверочный пример, готовые функции и чек-лист для 401 signature_invalid.
- [Callback-и](/callbacks.md): Как работают callback-и — когда приходят, куда и сколько раз, тело и заголовки, проверка подписи HMAC-SHA256, повторы и смена статуса, что делать без callback-а, ротация секрета.
- [Справочник API](/api-reference.md): Все методы API — пути, поля, ответы и примеры, собранные из спецификации OpenAPI.
- [Изменения](/changelog.md): История изменений API и документации.
- [Для ИИ-агентов](/ai-agents.md): Как дать ИИ-ассистенту эту документацию — llms.txt, Markdown-версии страниц и MCP-сервер для Claude Code, Cursor, Codex и ChatGPT.

## Documentation in English

- [Overview](/en/index.md): What the payment API is, integration in five steps, environments and general API conventions.
- [Quickstart](/en/quickstart.md): From cabinet setup to the first signed SBP payment and callback handling in about 15 minutes.
- [Sandbox](/en/sandbox.md): The API test environment — addresses, test project, test requisites, how to set a payment outcome and read the result.
- [SBP payments](/en/sbp.md): Creating an SBP pay-in, request and response fields, USDT settlement, what to show the payer, statuses, polling and callbacks, edge cases.
- [Card payments](/en/card.md): A card transfer pay-in (card_transfer), how it differs from SBP, what to show the payer and edge cases.
- [Statuses and errors](/en/statuses.md): Payment statuses, error_code values, API HTTP errors and when to retry.
- [Idempotency and limits](/en/idempotency.md): How to safely retry payment creation with merchant_payment_id, nonces and project rate limits.
- [Request signing](/en/signing.md): The RFC 9421 Ed25519 signature profile, how the signature base is built, the shared test vector, ready-made functions and a 401 signature_invalid checklist.
- [Callbacks](/en/callbacks.md): How callbacks work — when they arrive, where and how many times, body and headers, HMAC-SHA256 signature verification, retries and status changes, what to do without a callback, secret rotation.
- [API reference](/en/api-reference.md): Every API method — paths, fields, responses and examples generated from the OpenAPI spec.
- [Changelog](/en/changelog.md): History of API and documentation changes.
- [For AI agents](/en/ai-agents.md): How to give an AI assistant these docs — llms.txt, Markdown pages and the MCP server for Claude Code, Cursor, Codex and ChatGPT.

## Optional

- [OpenAPI](/openapi/openapi.yaml): спецификация API / API spec