Изменения¶

Новые поля в ответах и callback-ах добавляются без смены версии API — игнорируйте незнакомые поля. О несовместимых изменениях предупредим заранее.

2026-10-01¶

Callback-и — раздел Callback-и расширен.

Повторы доставки: 3 попытки — сразу, через 30 и через 60 секунд (было 10 попыток за ~2,5 минуты). Ручной повтор службой поддержки — одна попытка.
Новые разделы: как работает доставка, смена статуса после закрытия (canceled → completed, completed → canceled, новый amount), куда приходит callback, как обрабатывать, что делать без callback-а, частые проблемы, тестовые заявки, чек-лист.

API v1 — формат заявки и callback-а приведён к итоговой спецификации (до первых боевых интеграций).

Расчёт settlement переименован в merchant_information: course (был exchange_rate) и rate (был fee_percent) теперь числа с двумя знаками, amount_rate и amount_usdt_rate — прежние net_amount и net_amount_usdt.
В ответе появились flow, is_test и updated_at; поля bank больше нет.
Callback — короткое событие: id, event_id, суммы, status, currency, payment_method, bank_code, merchant_payment_id, rate, course, is_intrabank, is_test, project_id. Реквизиты и суммы в USDT — в GET /api/v1/payments/{id}.
Проверочный пример подписи callback-а обновлён под новое тело.

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

Первая версия документации для мерчантов на русском и английском.
Примеры подписи запросов и проверки callback-ов на curl, PHP, Python, Node.js и Go, проверенные на общих проверочных примерах.
Markdown-версии страниц, llms.txt и MCP-сервер документации для ИИ-агентов.

API v1

POST /api/v1/payments — создание заявки, GET /api/v1/payments/{id} — чтение.
Запрос: merchant_payment_id (1–64 символа A-Za-z0-9._:-), amount в основных единицах валюты, payment_method; необязательные currency (RUB), geo_code (RU), bank_code, is_intrabank, callback_url.
Срок заявки задаётся настройкой проекта, по умолчанию 15 минут. Не оплаченная к сроку заявка становится canceled, и приходит callback.
Ответ: банк реквизита bank и расчёт settlement — курс, ставка и суммы в USDT.
Callback приходит о completed и canceled; тело — та же заявка плюс event_id и project_id.
Отказы до приёма заявки (429, 503, подпись, повтор nonce, размер тела, неверное тело или поля) не занимают merchant_payment_id.
Ответ 422 содержит payment_id, если заявка успела сохраниться. Мерчант на паузе получает 422 payment_not_routable.