Единый номер операции
Он связывает игрока, сумму, валюту, способ оплаты, платежного провайдера и всю историю обработки.
Документация / Платежный сценарий
Как работает платежный API
Разберите полный путь платежа: от создания депозита и подтверждения оплаты до зачисления средств, вывода, возврата и финансовой сверки.
Депозит
создание и зачисление
Выплата
проверка и отправка
Статусы
подтверждение операций
Сверка
контроль финансов
Путь платежа
От заявки до итогового результата
01
Создать операцию
Зафиксировать игрока, сумму, валюту, способ оплаты и уникальный номер операции.
02
Подтвердить оплату
Перевести игрока на платежную страницу, запросить подтверждение банка или провести оплату напрямую.
03
Получить итоговый статус
Проверить ответ платежного провайдера и подтвердить окончательный результат операции.
04
Обновить баланс и учет
Один раз зачислить или списать средства, учесть комиссию и записать операцию для сверки.
Обзор
Каждый платеж проходит контролируемые этапы
Платформа присваивает операции собственный номер, связывает ее с ответом платежного провайдера и меняет финансовое состояние только после подтвержденного результата. Повторный запрос не должен создавать второе списание или зачисление.
Понятные статусы
Операция проходит только разрешенные этапы и не меняет завершенный результат без отдельной корректировки.
Отдельный финансовый учет
Статус платежа, изменение баланса, комиссия и учетная запись связаны между собой, но проверяются отдельно.
Сценарий депозита
Типовой сценарий депозита
Депозит начинается с создания внутренней операции и заканчивается однократным зачислением после подтверждения платежного провайдера.
01
Проверить запрос и создать операцию
Платформа проверяет игрока, KYC, лимиты, валюту, сумму и способ оплаты, затем присваивает операции внутренний номер.
02
Передать платеж провайдеру
Провайдер получает сумму, валюту, данные игрока, адрес возврата, адрес уведомлений и необходимые реквизиты.
03
Подтвердить оплату
Игрок подтверждает платеж на внешней странице, через 3-D Secure или в банковском приложении.
04
Получить подтверждение и зачислить средства
После проверки подписи и итогового статуса платформа один раз увеличивает баланс игрока и завершает операцию.
Вывод и возврат
Вывод средств, отмена и возврат
Исходящие операции требуют проверки игрока, доступного баланса, рисков, реквизитов и итогового ответа платежного провайдера.
Проверка игрока
KYC, возраст, статус аккаунта, лимиты, самоисключение и разрешенные способы вывода.
Проверка рисков
AML, признаки мошенничества, условия отыгрыша, источник средств и подтверждение оператора.
Резервирование суммы
Сумма блокируется на балансе до получения окончательного результата выплаты.
Отправка платежному провайдеру
Создается отдельная заявка на выплату с уникальным номером и подтвержденными реквизитами получателя.
Ожидание результата
Платформа принимает промежуточные статусы и не списывает сумму повторно.
Возврат
Возврат создается как отдельная операция, связанная с исходным платежом и собственной суммой.
Отмена
Отмена возможна только до необратимого этапа и не заменяет возврат уже завершенной операции.
Финальная сверка
Отчет провайдера, данные выплаты, комиссии и изменения баланса должны показывать одинаковый результат.
Статусы операции
Рекомендуемая модель статусов
Внутренние статусы объединяют разные ответы платежных провайдеров в единую и понятную для платформы модель.
Создана
Операция создана внутри платформы, но еще не отправлена или не принята провайдером.
Нужно действие
Игроку необходимо подтвердить оплату, ввести реквизиты или выполнить действие в банке.
Обрабатывается
Провайдер принял операцию, но окончательный результат еще не подтвержден.
Завершена
Операция успешно завершена, после чего выполняется однократное изменение баланса.
Отклонена
Операция завершена отказом с сохраненной причиной и без повторного списания или зачисления.
Не подтверждена
Итог операции неизвестен из-за разрыва связи, задержки ответа или противоречивых данных.
Неизвестный результат нельзя считать отказом
Платеж мог быть принят провайдером даже без своевременного ответа. Сначала запросите актуальный статус или дождитесь подтверждения, и только затем решайте вопрос о повторной операции.
Надежность и сверка
Защита от повторов и финансовая сверка
Надежность платежного API определяется безопасным поведением при повторных запросах, задержанных подтверждениях и частичных сбоях.
Защита от повторной операции
Каждый депозит, вывод и возврат получает уникальный номер.
Повторный запрос возвращает существующий результат и не создает новую финансовую операцию.
Повторное уведомление проверяется по номеру события и текущему состоянию платежа.
Изменение баланса связывается с номером платежа и применяется только один раз.
Финансовый учет и сверка
Отдельно хранить сумму, комиссию, итог к зачислению, валюту и номер провайдера.
Не переписывать завершенную запись задним числом, а создавать отдельную корректировку.
Сверять операции API, отчеты провайдера, изменения баланса и выплаты.
Фиксировать расхождение, его причину, ответственного и результат исправления.
Тестирование
Что проверить перед запуском
Проверяйте успешную оплату, отказ, потерю связи, повторное подтверждение, неизвестный результат, возврат и финансовую сверку.
Успешный депозит и вывод
Все промежуточные статусы, подтверждение, изменение баланса и итоговая отчетность.
Отказ в операции
Недостаточно средств, неверные реквизиты, превышение лимита, отказ банка, проверка риска и недоступный способ оплаты.
Потеря связи
Соединение обрывается после отправки запроса, а подтверждение приходит позже или запрашивается отдельно.
Повторные запросы
Одна и та же операция или подтверждение приходят повторно после завершения обработки.
Возврат и отмена
Полный и частичный возврат, отмена до обработки и запрет отмены завершенной операции.
Сверка
Сумма, комиссия, итоговый статус, баланс и отчет провайдера совпадают после всех сценариев.
Чек-лист перед запуском
Рабочие платежи включаются после проверки статусов, подтверждений, защиты от повторов, баланса и финансовой отчетности.
Для тестовой и рабочей среды используются разные доступы, адреса уведомлений и учетные записи.
Возврат пользователя на сайт не используется как доказательство успешной оплаты.
Подпись и номер события проверяются до изменения баланса.
Депозит, вывод и возврат защищены от повторного выполнения.
Неизвестный статус уточняется у провайдера и проверяется при сверке.
Настроены уведомления об ошибках, отчеты PSP и порядок разбора расхождений.
Нужно спроектировать платежный сценарий?
Передайте список PSP, способов оплаты, валют, рынков, правил работы с балансом и статусов. APIACE поможет выстроить депозит, вывод, возврат, подтверждение и финансовую сверку.