Повтор запроса
Как повторить создание платежа после обрыва связи и не создать второй платёж.
Ответ на создание платежа может не дойти: оборвалась связь, истёк срок ожидания, пришёл ответ 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 называет уже созданный платёж. Если ответ на создание не дошёл, а ключа не было, платёж находят по номеру заказа: поиск по номеру заказа.