# Изменения

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

## 2026-10-01 { #2026-10-01 }

**Callback-и** — раздел [Callback-и](callbacks.md) расширен.

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

## 2026-09-30 { #2026-09-30 }

**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-а обновлён под новое тело.

## 2026-09-29 { #2026-09-29 }

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

- Первая версия документации для мерчантов на русском и английском.
- Примеры подписи запросов и проверки 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`.