API-клиент может отправить запрос, дождаться тайм-аута и повторить его, не зная, завершилась ли первая операция. Игровой агрегатор или очередь событий также могут повторно доставить тот же callback. Если платформа казино примет такое сообщение за новую ставку, выплату, отмену или бонус, возникнут реальные расхождения в финансовом учете. Нужно отделить попытку доставки от бизнес-транзакции и обеспечить однократный финансовый эффект в устойчивом журнале оператора. Поставщики используют разные идентификаторы, коды дубликатов и правила повторов; универсального ответа для любого API нет. Здесь рассмотрены проверка подлинности, атомарное проведение операций, повторная выдача результата, события не по порядку, сверка и приемочное тестирование. [1] [2] [4]
Опубликовано
Повторная доставка сообщения допустима, повторный финансовый эффект недопустим.
Содержание
Почему один callback приходит несколько раз?
Отправитель может не получить HTTP-ответ, хотя получатель уже записал транзакцию. Тогда он повторяет запрос, либо очередь повторно доставляет сообщение без подтвержденного получения. Доставка по модели at-least-once допускает дубли, а порядок сообщений по умолчанию может нарушаться. Повтор сам по себе не означает атаку или вторую финансовую операцию. [4] [5]
В казино списание, начисление и отмена не должны выполняться второй раз из-за повторного сообщения. У бизнес-операции, входящего callback и HTTP-ответа разные жизненные циклы. St8 и 7SoftTech используют идентификаторы транзакций для распознавания повторов, но детали ответа и крайних случаев различаются. [1] [2]
Какие идентификаторы нужны для идемпотентности?
Разделяйте ID попытки доставки, подтвержденного поставщика, бизнес-транзакции, типа действия, исходной операции и игрового раунда. Предотвращать повторную проводку должен согласованный бизнес-ключ. Учитывайте область уникальности, указанную в контракте: идентификаторы разных поставщиков или операторских проектов могут совпадать. [1] [2] [3]
Идентификатор
Назначение
Правило
Поставщик / проект
Область имен
Проверить источник
ID транзакции
Финансовое действие
Уникальность по контракту
Тип операции
Списание или выплата
Учитывать модель API
ID события
Одна доставка
Не всегда ключ кошелька
ID исходной операции
Связь отмены
Проверить родительскую запись
Раунд и игрок
Контекст проводки
Не заменять ID транзакции
Для ключа идемпотентности храните также контрольную характеристику запроса и итоговое состояние. Если под прежним ID приходят другие сумма, валюта или игрок, это конфликт, а не повод выполнить новую операцию. Подход к одному намерению запроса объясняет AWS. [3] [4]
Что проверить до поиска дубликата?
Сначала подтвердите подлинность callback по подписи или иному механизму поставщика. Затем проверьте, имеет ли источник право обращаться к кошельку нужного игрока и выполнять операцию в данной валюте. Знакомый ID из непроверенного сообщения не доказывает выполнение транзакции. OWASP рекомендует проверять подлинность до дедупликации. [1] [6]
Проверить подпись, допустимый интервал времени и защиту от повторного использования сообщения по правилам поставщика.
Связать подтвержденный проект с правильным игроком, кошельком и валютой.
Проверить точность суммы, тип действия, ID транзакции и ссылку на исходную операцию.
Сравнить полезную нагрузку с сохраненным отпечатком до ответа о дубликате.
Для расследования достаточно безопасных идентификаторов, отметок времени и хешей без секретов и лишних персональных данных. Нельзя отвечать успехом на поддельный запрос только потому, что его номер совпал с уже проведенной транзакцией. [2] [6]
Как выглядит полный путь обработки callback?
После проверки подлинности система находит или резервирует уникальный бизнес-ключ, сравнивает содержимое запроса, проводит допустимое изменение баланса и сохраняет итог в одной устойчивой операции БД. Повтор того же подтвержденного действия возвращает сохраненный результат, не меняя баланс. Неопределенные исходы передаются на сверку. [1] [4] [6]
Проверить источник callback и разрешенного игрока в контексте поставщика.
Определить согласованный бизнес-ключ и проверить связь отмены с исходной операцией.
Атомарно создать или найти транзакцию, выполнить допустимую проводку и сохранить итог.
Вернуть ответ по контракту либо отправить неясный случай на сверку без нового финансового эффекта.
⊕Увеличить схемуНесколько попыток доставки относятся к одной сохраненной бизнес-транзакции.
Коммит БД и отправку HTTP-ответа обычно нельзя объединить в одну атомарную операцию между независимыми системами. Поэтому нужно предусмотреть случай, когда запись успешно зафиксирована, а ответ потерян: именно тогда отправитель повторит уже выполненный запрос. [4] [7]
Как БД обеспечивает единственный финансовый эффект?
Создайте реальное ограничение уникальности бизнес-ключа и проводите регистрацию запроса, запись в журнале, изменение баланса и фиксацию итога в подходящей транзакции. Отдельный SELECT перед UPDATE недостаточен при конкуренции: два обработчика могут одновременно увидеть свободный ключ. Решающее правило должны обеспечивать БД и блокировки. [3] [4]
Состояние
Безопасное действие
Проверяемый риск
Новый ключ
Одна проводка и итог
Параллельные запросы
Готов, те же данные
Вернуть сохраненный итог
Второе начисление
В обработке
Подождать либо сверить
Конкурирующие потоки
Ключ тот же, данные иные
Отклонить конфликт
Иная сумма или игрок
Откат до коммита
Контролируемый повтор
Сбой после резервирования
Очередь входящих событий полезна, но ее подтверждение не доказывает, что деньги проведены. Нужны явный жизненный цикл транзакции, ссылка на финансовую запись и неизменяемый итог. Отмена может быть отдельной проводкой или переходом исходной операции — это задает контракт конкретного поставщика. [1] [3]
Как отвечать на дубликаты и конфликтные повторы?
На проверенный дубль уже сохраненной операции возвращайте исходный успешный результат либо точный код дубликата по правилам интеграции. Универсального HTTP 200, 409 или JSON-кода для любого казино нет. St8, 7SoftTech и GR8 Tech описывают разные поля и значения ошибок. [1] [2] [3]
Зафиксировать форму ответа для неизменного бизнес-ID и того же смысла операции.
Отклонять повтор с другой суммой, валютой, игроком или несовместимым действием.
После коммита с потерянным ответом возвращать результат первой операции без второй проводки.
Отличать окончательный бизнес-отказ от временного технического сбоя для решения о повторе.
Не воспроизводите старый снимок баланса, если API требует актуальный, и не придумывайте код дубликата, отсутствующий в контракте. Уточните, как поставщик трактует повтор, отмену и повтор отклоненной операции. Сам по себе HTTP POST не считается безопасным для произвольного автоматического повтора. [2] [3] [7]
Когда повторять запрос, откладывать или останавливать?
Решение зависит от идемпотентности операции и типа сбоя. Тайм-аут или временная ошибка сервера не показывают, завершилась ли первая попытка. Недействительная подпись, некорректные данные и окончательный отказ не должны бесконечно повторяться. Используйте ограниченное число попыток, возрастающие интервалы со случайным смещением и путь сверки. [4] [6] [7]
Ситуация
Рекомендуемое действие
Почему
Тайм-аут после отправки
Сверить или повторить тот же ID
Коммит неизвестен
Временная 5xx / лимит
Повтор в рамках контракта
Преходящий сбой
Неверная подпись
Отклонить и сообщить
Нет аутентификации
Окончательный отказ
Остановить по правилам API
Повтор не меняет решение
Ответ потерян после коммита
Вернуть сохраненный итог
Не списывать второй раз
Очередь автоматических повторов и ручные исправления должны быть разделены. Оператору необходимо знать, какие сообщения безопасно воспроизвести, какие требуют проверки состояния и какие передаются ответственному специалисту. Менять ID ради повторного проведения неясной операции нельзя. [3] [4]
Что делать, если события пришли не по порядку?
Очередь может поменять порядок доставки, а отмена ставки иногда приходит раньше исходного списания. Некоторые контракты требуют сохранить отметку об отмене, чтобы позднее исходное действие уже нельзя было провести. В других API жизненный цикл иной, поэтому нельзя применять один набор кодов ошибок ко всем поставщикам. [1] [2] [5]
Сохранять ссылку на исходное действие и состояние бизнес-транзакции, а не только время получения.
Определить допустимые переходы списания, начисления, отмены и корректировки для каждого API.
Хранить устойчивую отметку отмены до прихода исходной операции, если контракт этого требует.
Передавать неразрешимые связи на сверку, не создавая выдуманных проводок.
Порядок получения сообщений не равен порядку финансовых событий. Нельзя сортировать проводки только по времени в удаленном запросе. Решение зависит от идентичности операции, связей между действиями и достоверного состояния у оператора или поставщика. [2] [5]
Как сверять и отслеживать повторы после сбоев?
Callback может пройти проверку, но не попасть в журнал, либо успешно попасть в журнал без подтверждения отправителю. Следите отдельно за доставкой и финансовым состоянием. Неясные ключи сверяйте с журналом оператора и данными поставщика; расхождения должны иметь явный процесс расследования. Обновление баланса в интерфейсе этого не заменяет. [1] [3] [4]
Считать попытки, проверенные дубли, ошибки подписи, конфликты данных и очередь сверки по каждому поставщику.
Подавать сигнал при частых тайм-аутах, зависших транзакциях, ранних отменах и расхождениях.
Разрешать ручной повтор только ответственным лицам с исходными ID и записью причины.
Сопоставлять журнал оператора и историю поставщика до создания корректирующей проводки.
Хранить данные для поиска дублей не меньше согласованных сроков повторов и расследований.
Не направляйте полные финансовые или персональные данные в общую аналитику. Для аудита используйте безопасные ID, хеши, время, переходы статусов и действия операторов с ограничением доступа и срока хранения. На панели нужно разделять число доставленных дублей и реальный финансовый дисбаланс. [4] [6]
Успешные ставка и выигрыш в обычном сценарии не доказывают идемпотентность. Сертификация должна включать повторные ID, конфликтные данные, параллельные обработчики, потерянные ответы, отмены и задержанные сообщения по контракту поставщика. 7SoftTech прямо описывает тесты повторных bet, win и cancel. [2]
Провести списание или начисление, повторить тот же подписанный callback и проверить единственную проводку.
Передать прежний ID с другой суммой, валютой или игроком и подтвердить безопасный отказ.
Одновременно отправить две корректные доставки, смоделировать сбой после коммита и проверить сохраненный результат.
Отправить отмену раньше исходной операции и проверить правила конкретного поставщика.
Восстановить соединение после сбоя, доставить задержанные события и сверить журнал с аудитом.
До запуска согласуйте с каждым партнером коды ответов, область уникальности, интервал повторов и отмену. Успех — не отсутствие дублей, а однократное правильное проведение каждой разрешенной бизнес-операции даже при повторных запросах, потерянных ответах и нарушенном порядке доставки. [1] [3] [4]