Как организовать идемпотентный REST API, чтобы повторный запрос клиента не привёл к дублированию операции?

Проблема: клиент может отправить повторный запрос (например, из-за сетевого таймаута), и тогда деньги спишутся дважды.

Решение:

1. Клиент добавляет Idempotency-Key в заголовок.

2. Сервер сохраняет результат операции в БД вместе с ключом.

3. Если приходит повторный запрос с тем же ключом — сервер возвращает сохранённый ответ.

func CreatePayment(w http.ResponseWriter, r *http.Request) {
		key := r.Header.Get("Idempotency-Key")
		if resp, ok := storage[key]; ok {
				w.Write(resp)
				return
		}
		// выполняем платёж
		result := []byte("ok")
		storage[key] = result
		w.Write(result)
}

Вывод: идемпотентность обязательна для финансовых и критичных API.