Ломающие изменения объявляются заранее и всегда называют путь миграции. Этот список читают люди, которые решают, деплоить ли в пятницу.
Списки платежей теперь возвращают признак final рядом со статусом — потребителю больше не нужно держать собственную таблицу финальных состояний. Частичный возврат документирован явно: событие остаётся payment.refunded, различие несёт поле status в теле.
Каждая операция несёт x-readiness: ready или partial. Справочник показывает этот признак прямо в заголовке эндпоинта — разрыв в возможностях виден при чтении, а не на приёмочном тестировании.
Допустимое расхождение часов при проверке подписи уменьшено с 15 до 5 минут. Nonce остаётся одноразовым в пределах окна.
Ломающее изменение
Клиенты с рассинхронизированными часами начнут получать 401 timestamp_out_of_range. Синхронизируйте NTP перед обновлением и повторяйте запрос с новыми timestamp, nonce и подписью — Idempotency-Key при этом не меняется.
Доставку можно переотправить вручную. Replay сохраняет прежний X-Webhook-Id, поэтому корректно построенная дедупликация на стороне мерчанта не создаст дубль.
Дробное поле amount помечено устаревшим и будет удалено не ранее 01.03.2027. Используйте amount_minor: целое в минимальных единицах валюты.