Повтор запроса

Как повторить создание платежа после обрыва связи и не создать второй платёж.

Ответ на создание платежа может не дойти: оборвалась связь, истёк срок ожидания, пришёл ответ 5xx. Платёж при этом мог быть создан. Повтор с тем же ключом повтора вернёт этот платёж и второго не создаст.

Ключ повтора

Заголовок Idempotency-Key: от 1 до 128 видимых знаков ASCII без пробелов. Один ключ на одно намерение заплатить.

Что пришлоОтвет
Тот же ключ и то же телоТот же платёж в нынешнем виде, код 200 или 201 и заголовок Idempotency-Replayed: true. Нового платежа нет
Тот же ключ и другое телоОтказ 409 с правилом idempotency_key_reused
Тот же ключ, а первый запрос ещё идётОтказ 409 с правилом request_in_progress. Повторите через несколько секунд
  • Тело сравнивается по содержанию: порядок полей в JSON значения не имеет.
  • Ключ действует в своём контуре: тестовый и боевой не пересекаются.
  • Если отклонён сам запрос (неверное тело, сервис недоступен, сумма вне границ), платёж не создан и ключ не занят. Исправьте запрос и отправьте его с тем же ключом.
  • Если первый запрос оборвался раньше, чем создал платёж, через 60 секунд ключ освобождается, и повтор исполняется заново.

Без ключа

От второго платежа защищает номер заказа: reference уникален у мерчанта в контуре. Повтор с тем же номером получает отказ 409 с правилом payment_reference_exists, а details.paymentId называет уже созданный платёж. Если ответ на создание не дошёл, а ключа не было, платёж находят по номеру заказа: поиск по номеру заказа.

Правило для кода кассы

API v1 · собрано 18.11.2026 · выпуск f13e6bf

Справочник методов собирается из кода сервера: он не описывает адрес, которого нет.