1. Зачем нужна
Если ответ на запрос потерялся (таймаут сети, перезапуск сервера), его безопасно повторить: операция не создастся дважды.
2. Как использовать
Для POST /v1/payments и POST /v1/payouts заголовок обязателен. Используйте ID заказа или UUID попытки (8–128 символов: латиница, цифры, _ - : .).
| Key | Value |
|---|---|
| Idempotency-Key | order-1042 |
3. Поведение
| Ситуация | Ответ |
|---|---|
| Тот же ключ и то же тело | Исходный ответ + заголовок Idempotent-Replayed: true |
| Тот же ключ, другое тело | 422 idempotency_mismatch |
| Первый запрос ещё выполняется | 409 idempotency_in_progress — повторите позже |
| Запрос завершился ошибкой | Ключ освобождается — можно повторить |