Собственный платёжный шлюз (Турция)

Процессинговый центр с нуля: интеграция в турецкие банки, приём и роутинг платежей, антифрод-система, панель мониторинга.
- Клиент
- Под NDA
- Сфера
- Платёжная инфраструктура, Турция
- Что делали
- Процессинг
- Банковские интеграции
- Антифрод
Суть. Построить с нуля собственный процессинг: платёж принимается, проверяется антифродом, уходит в подходящий турецкий банк и виден в панели мониторинга, без стороннего процессора посередине.
Введение
Пока платежи идут через сторонний процессор, бизнес зависит от его тарифов, правил и доступности. Если у процессора сбой, приём денег останавливается целиком, а добавить второй банк или сменить маршрут нельзя без нового договора и новой интеграции.
Для клиента мы построили процессинговый центр с нуля и подключили его напрямую к банкам Турции. Шлюз принимает платежи, проверяет их антифрод-системой, выбирает маршрут через подключённые банки и показывает прохождение каждой операции в панели мониторинга.
Боль - запрос
Зависимость от одного стороннего процессора.
Собственный шлюз с прямыми банковскими интеграциями.
Сбой банка останавливает приём платежей.
Маршрутизация между подключёнными банками.
Мошеннические платежи замечают уже по возвратам.
Антифрод-проверка до отправки платежа в банк.
Повторный запрос от магазина может списать деньги дважды.
Идемпотентный приём: один ключ - один платёж.
Непонятно, где застрял конкретный платёж.
Панель мониторинга со статусом каждой операции.
Описание проекта
Шлюз стоит между мерчантами и банками: снаружи один API для приёма платежей, внутри маршрутизация, проверка риска, учёт и сверка с каждым банком. Проект закрытый, клиент не раскрывается.
- API приёма платежей. Создание платежа, статусы, возвраты и уведомления мерчанту.
- Банковские интеграции. Отдельный адаптер на каждый банк Турции: свой протокол и свои коды ответов, приведённые к единым статусам.
- Маршрутизация. Правила выбора банка по типу платежа, сумме и доступности маршрута.
- Антифрод. Правила и скоринг до отправки платежа в банк, спорные операции останавливаются на проверку.
- Панель мониторинга. Прохождение операций, доля успешных по маршрутам, ошибки банков.
Архитектура решения
Как система выглядит в работе. Ниже - откуда она берёт данные, где их обрабатывает и куда отдаёт результат.
- МерчантШлюзPOST /payments
- ШлюзАнтифродоценить риск
- АнтифродШлюз12% · пропустить
- ШлюзБанкавторизация
- БанкШлюзодобрено
- ШлюзМерчантwebhook: payment.succeeded
- создан16:20:31
- проверен16:20:31
- авторизован16:20:32
- списан16:20:33
1 250 TRY · pay_7Q2K91XM · маршрут bank_b.primary
Если банк не ответил на платёж, шлюз не отправляет его повторно: сначала запрашивает статус, и только неотправленные операции уходят по резервному маршруту.
Полная схема архитектуры и пример события
Мерчанты
- Сайты и приложения мерчантовсоздают платежи через API
- Кабинет мерчантаоперации, возвраты, отчёты
Что разработали мы
- API и машина состоянийидемпотентность, статусы
- Антифродправила и скоринг до банка
- Маршрутизациявыбор банка, резервный маршрут
- Адаптеры банков Турцииединые статусы и коды ответов
Подключено:Сверка
Мониторинг
- Панель мониторингаоперации, маршруты, ошибки
- Уведомления мерчантуwebhook о смене статуса
- Очередь разбораспорные и несверенные операции
Так это выглядит в работе
WEBHOOK/merchant/callbacks/payments
event- payment.succeeded
payment_id- pay_7Q2K91XM
idempotency_key- ord-55821-1
amount- 1250
currency- TRY
route- bank_b.primary
fraud_score- 12%
attempts- 1
status- captured
ts- 2026-09-18T16:20:33+03:00
Как проходит платёж
- Запрос. Мерчант создаёт платёж с ключом идемпотентности. Повтор с тем же ключом возвращает уже созданный платёж.
- Проверка риска. Антифрод оценивает операцию: подозрительную останавливает, остальные пропускает дальше.
- Маршрут. Шлюз выбирает банк по правилам. Если банк недоступен, платёж уходит по резервному маршруту. Если банк не ответил уже после отправки, повтора нет: сначала шлюз запрашивает статус операции.
- Результат и сверка. Мерчант получает уведомление о статусе, операция появляется в панели, а затем сверяется с реестром банка.
Почему это не просто интеграция с банком
Самое опасное в платежах - неопределённость. Банк может принять операцию и не успеть ответить, магазин может отправить один запрос дважды, уведомление может прийти раньше ответа. Поэтому у каждого платежа есть ключ идемпотентности и машина состояний: статус меняется только по разрешённым переходам, а неизвестный результат сначала выясняется у банка и только потом решается, что делать дальше.
Вторая половина работы - сверка. Шлюз ведёт свой журнал операций и сравнивает его с реестрами банков. Расхождение, то есть платёж, который шлюз считает успешным, а банк нет, или наоборот, попадает в отдельную очередь на разбор, а не теряется в общих цифрах.
Результат проекта
- Без стороннего процессора. Приём, маршрутизация, проверка рисков и мониторинг работают в одной собственной системе.
- Несколько банков. Платёж уходит по подходящему маршруту через подключённые банки Турции.
- Риск до списания. Антифрод проверяет операцию до отправки в банк.
- Каждая операция на виду. Панель показывает, где платёж и чем он закончился.
- Сверка с банками. Расхождения находятся по реестрам, а не по жалобам.
Проект в цифрах
- Длительность
- Около 7 месяцев: архитектура и API, подключение первого банка, антифрод и маршрутизация, панель и сверка
- Команда
- 1 project manager
- 1 архитектор
- 3 back-end разработчика
- 1 front-end разработчик (панель мониторинга)
- 1 QA-инженер
- 1 DevOps-инженер
- 0сторонних процессоров между шлюзом и банками
- 1 APIдля мерчантов, сколько бы банков ни стояло за ним
- До банкаантифрод-проверка каждой операции
Технологии и интеграции
- Платёжный API для мерчантов
- Идемпотентность и машина состояний платежа
- Интеграции с банками Турции
- Маршрутизация платежей
- Антифрод: правила и скоринг
- Сверка с банковскими реестрами
- Панель мониторинга
Частые вопросы
Как исключить двойное списание?
Каждый запрос мерчанта несёт ключ идемпотентности, и повтор возвращает уже созданный платёж. Если банк не ответил, шлюз сначала выясняет статус операции и только потом решает, повторять ли её.
Что будет, если банк недоступен?
Новые платежи уходят через другой подключённый банк. Операции, по которым ответа не было, остаются в ожидании и проверяются запросом статуса и сверкой.
Можно ли подключить банки другой страны?
Да. Банк подключается отдельным адаптером, который переводит его протокол и коды ответов в единые статусы шлюза. Ядро, антифрод и панель при этом не меняются.
Как настраивается антифрод?
Правилами и порогами скоринга: лимиты, частота попыток, повторяющиеся данные. Пороги подбираются на реальном потоке, чтобы не отсекать честных плательщиков.
Проект под NDA: в публичном тексте только то, что согласовал клиент. Детали внедрения расскажем в переписке.


