Сделайте обработчик оплаты идемпотентным: повторный запрос с тем же ключом не должен списать деньги второй раз
Проверила команда Сопровод · Обновлено
Короткий ответ
Клиент создает ключ идемпотентности до первой попытки и шлет его с каждым повтором. Сервер хранит по ключу параметры запроса и готовый ответ. Пришел знакомый ключ с теми же параметрами — верните сохраненный ответ без списания. Тот же ключ с другой суммой — ошибка: клиент перепутал запросы. Новый ключ — новая оплата.
Почему этот вопрос задают
Сеть рвется посреди оплаты, клиент повторяет запрос, и без защиты деньги спишутся дважды. На этой задаче кандидат показывает, что думает о сбоях и повторах раньше, чем об основном сценарии.
Условие задачи
Музыкальный стриминг продает подписку за 299 ₽ в месяц. Приложение вызывает pay(key, user, amount), а при таймауте повторяет запрос с тем же ключом. Напишите pay так, чтобы повтор с тем же ключом вернул тот же платеж и не списал деньги второй раз. Новый ключ — новый платеж. Тот же ключ с другой суммой — ошибка. Начальный баланс пользователя user-7 — 1000 ₽.
Как подойти к решению
- Создайте хранилище: ключ — параметры запроса и сохраненный ответ
- Проверьте ключ до списания и сравните параметры с сохраненными
- Верните сохраненный ответ при совпадении и бросьте ошибку при другой сумме
- Спишите деньги и сохраните ответ под ключом, только если ключ новый
- Прогоните повтор, новый ключ и старый ключ с другой суммой и сверьте баланс
Решение
Второй запрос с ключом a1 вернул тот же платеж №1 и не тронул баланс, ключ b2 создал платеж №2. Повтор a1 с суммой 599 получил ошибку. В HTTP это ответ 422. Проверка ключа стоит O(1). Код работает в одном процессе, гонку двух одновременных повторов он не закрывает.
payments = {} # ключ идемпотентности -> параметры запроса и ответ
balance = {"user-7": 1000}
def pay(key, user, amount):
if key in payments:
params, response = payments[key]
if params != (user, amount):
raise ValueError(f"ключ {key} уже использован с другими параметрами")
return response
balance[user] -= amount
payments[key] = ((user, amount), {"payment": len(payments) + 1, "amount": amount})
return payments[key][1]
for key, amount in [("a1", 299), ("a1", 299), ("b2", 299), ("a1", 599)]:
try:
print(key, pay(key, "user-7", amount), balance["user-7"])
except ValueError as e:
print(key, type(e).__name__, e)a1 {'payment': 1, 'amount': 299} 701
a1 {'payment': 1, 'amount': 299} 701
b2 {'payment': 2, 'amount': 299} 402
a1 ValueError ключ a1 уже использован с другими параметрамиЧто спросят следом
Два одинаковых запроса пришли одновременно на два экземпляра сервиса — что будет?
Что делать, если списание прошло, а сервис упал до сохранения ответа?
Сколько хранить ключи?
Доступно по подписке
Ответы на эти вопросы
Частые ошибки
«Отсею дубли: если за пять минут был платеж на ту же сумму, второй не проведу»
Так пропадет честная вторая оплата, например подписка в подарок, а повтор через шесть минут пройдет. Повтор от новой оплаты отличает только ключ, который присылает клиент
«На повтор с тем же ключом отвечу ошибкой „платеж уже проведен“»
Клиент после таймаута не знает, прошла ли оплата, и ошибка его запутает. Верните тот же ответ, что в первый раз, с тем же номером платежа
«Если ключ знакомый, но сумма другая, просто проведу новый платеж»
Тихий успех спрячет ошибку клиента: он переиспользовал ключ для другой операции. Сравнивайте параметры с сохраненными и отвечайте ошибкой, чтобы клиент сразу увидел проблему у себя
«Ключ сгенерирую на сервере и верну клиенту в ответе»
Если первый ответ потерялся, у клиента нет ключа для повтора, и защита не сработает. Ключ создает клиент до первой попытки, обычно это UUID, и хранит его до получения ответа
Сигналы для интервьюера
Сильный ответ
Привязывает ключ к пользователю и объясняет зачем: чужой ключ, присланный с другого аккаунта, не должен вернуть чужой платеж
Тревожный сигнал
Защищает от повтора только списание, а письмо о покупке отправляет до проверки ключа, и при повторе клиент получит его дважды
Красный флаг
Предлагает решить дубли на клиенте: заблокировать кнопку оплаты после нажатия, и считает, что серверу защита не нужна
Как еще могут спросить
- Что такое ключ идемпотентности и зачем он нужен в платежах?
- Как защитить API оплаты от двойного списания при повторных запросах?
- Как сделать POST-запрос идемпотентным?
- Что сервер должен ответить на повтор запроса с тем же
Idempotency-Key?











