Глоссарий
Ключ идемпотентности
Ключ идемпотентности — уникальное значение, обычно UUID, которое клиент посылает с запросом, создающим или меняющим что-то, чтобы повтор того же запроса после таймаута, сетевой ошибки или сбоя вернул тот же результат вместо дубля. Сервер хранит ключ вместе с ответом некоторое время и при повторе отдаёт сохранённый ответ; повтор с тем же ключом, но другим телом отклоняется. В платежах именно это делает повтор безопасным.
Зачем это платежам
Сервер мерчанта отправляет выплату, и соединение рвётся до ответа: ушла ли она? Без идемпотентности единственный безопасный ответ — проверить и надеяться; с ключом мерчант просто посылает тот же запрос снова и получает один результат. То же защищает создание платежей, возвраты и списания, а также собственные вызовы платформы к провайдерам, поддерживающим ключи.
Ключи, ссылки и вебхуки
Ссылка заказа мерчанта идентифицирует покупку; ключ идемпотентности — одну попытку вызвать API; идентификатор платежа платформы — получившийся платёж. Вебхуки несут идентификатор платежа и ссылку мерчанта, и мерчанту стоит считать доставку вебхука тоже повторяемой: одно и то же событие может прийти дважды.
На платформе
API Tranzify использует ссылку мерчанта как защиту от дублей: второй запрос со ссылкой, которую мерчант уже использовал, отклоняется с ошибкой вместо создания ещё одного платежа; идентификатор платежа и ссылка идут в каждом вебхуке.
Обновлено: 2026-11-08