Перейти к содержанию

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

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

Процессинговый центр с нуля: интеграция в турецкие банки, приём и роутинг платежей, антифрод-система, панель мониторинга.

Клиент
Под NDA
Сфера
Платёжная инфраструктура, Турция
Что делали
  • Процессинг
  • Банковские интеграции
  • Антифрод

Суть. Построить с нуля собственный процессинг: платёж принимается, проверяется антифродом, уходит в подходящий турецкий банк и виден в панели мониторинга, без стороннего процессора посередине.

Введение

Пока платежи идут через сторонний процессор, бизнес зависит от его тарифов, правил и доступности. Если у процессора сбой, приём денег останавливается целиком, а добавить второй банк или сменить маршрут нельзя без нового договора и новой интеграции.

Для клиента мы построили процессинговый центр с нуля и подключили его напрямую к банкам Турции. Шлюз принимает платежи, проверяет их антифрод-системой, выбирает маршрут через подключённые банки и показывает прохождение каждой операции в панели мониторинга.


Боль - запрос

  • Зависимость от одного стороннего процессора.

    Собственный шлюз с прямыми банковскими интеграциями.

  • Сбой банка останавливает приём платежей.

    Маршрутизация между подключёнными банками.

  • Мошеннические платежи замечают уже по возвратам.

    Антифрод-проверка до отправки платежа в банк.

  • Повторный запрос от магазина может списать деньги дважды.

    Идемпотентный приём: один ключ - один платёж.

  • Непонятно, где застрял конкретный платёж.

    Панель мониторинга со статусом каждой операции.


Описание проекта

Шлюз стоит между мерчантами и банками: снаружи один API для приёма платежей, внутри маршрутизация, проверка риска, учёт и сверка с каждым банком. Проект закрытый, клиент не раскрывается.

  • API приёма платежей. Создание платежа, статусы, возвраты и уведомления мерчанту.
  • Банковские интеграции. Отдельный адаптер на каждый банк Турции: свой протокол и свои коды ответов, приведённые к единым статусам.
  • Маршрутизация. Правила выбора банка по типу платежа, сумме и доступности маршрута.
  • Антифрод. Правила и скоринг до отправки платежа в банк, спорные операции останавливаются на проверку.
  • Панель мониторинга. Прохождение операций, доля успешных по маршрутам, ошибки банков.

Архитектура решения

Как система выглядит в работе. Ниже - откуда она берёт данные, где их обрабатывает и куда отдаёт результат.

МерчантШлюзАнтифродБанкPOST /paymentsоценить риск12% · пропуститьавторизацияодобреноwebhook: payment.succeeded
  1. МерчантШлюзPOST /payments
  2. ШлюзАнтифродоценить риск
  3. АнтифродШлюз12% · пропустить
  4. ШлюзБанкавторизация
  5. БанкШлюзодобрено
  6. ШлюзМерчантwebhook: payment.succeeded
  1. создан16:20:31
  2. проверен16:20:31
  3. авторизован16:20:32
  4. списан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
attempts
1
status
captured
ts
2026-09-18T16:20:33+03:00
Пример уведомления мерчанту об успешном платеже: повтор запроса с тем же ключом идемпотентности вернёт этот же платёж, а не создаст новый. Данные обезличены.

Как проходит платёж

  1. Запрос. Мерчант создаёт платёж с ключом идемпотентности. Повтор с тем же ключом возвращает уже созданный платёж.
  2. Проверка риска. Антифрод оценивает операцию: подозрительную останавливает, остальные пропускает дальше.
  3. Маршрут. Шлюз выбирает банк по правилам. Если банк недоступен, платёж уходит по резервному маршруту. Если банк не ответил уже после отправки, повтора нет: сначала шлюз запрашивает статус операции.
  4. Результат и сверка. Мерчант получает уведомление о статусе, операция появляется в панели, а затем сверяется с реестром банка.

Почему это не просто интеграция с банком

Самое опасное в платежах - неопределённость. Банк может принять операцию и не успеть ответить, магазин может отправить один запрос дважды, уведомление может прийти раньше ответа. Поэтому у каждого платежа есть ключ идемпотентности и машина состояний: статус меняется только по разрешённым переходам, а неизвестный результат сначала выясняется у банка и только потом решается, что делать дальше.

Вторая половина работы - сверка. Шлюз ведёт свой журнал операций и сравнивает его с реестрами банков. Расхождение, то есть платёж, который шлюз считает успешным, а банк нет, или наоборот, попадает в отдельную очередь на разбор, а не теряется в общих цифрах.


Результат проекта

  • Без стороннего процессора. Приём, маршрутизация, проверка рисков и мониторинг работают в одной собственной системе.
  • Несколько банков. Платёж уходит по подходящему маршруту через подключённые банки Турции.
  • Риск до списания. Антифрод проверяет операцию до отправки в банк.
  • Каждая операция на виду. Панель показывает, где платёж и чем он закончился.
  • Сверка с банками. Расхождения находятся по реестрам, а не по жалобам.

Проект в цифрах

Длительность
Около 7 месяцев: архитектура и API, подключение первого банка, антифрод и маршрутизация, панель и сверка
Команда
  • 1 project manager
  • 1 архитектор
  • 3 back-end разработчика
  • 1 front-end разработчик (панель мониторинга)
  • 1 QA-инженер
  • 1 DevOps-инженер
  • 0сторонних процессоров между шлюзом и банками
  • 1 APIдля мерчантов, сколько бы банков ни стояло за ним
  • До банкаантифрод-проверка каждой операции

Технологии и интеграции

  • Платёжный API для мерчантов
  • Идемпотентность и машина состояний платежа
  • Интеграции с банками Турции
  • Маршрутизация платежей
  • Антифрод: правила и скоринг
  • Сверка с банковскими реестрами
  • Панель мониторинга

Частые вопросы

  • Как исключить двойное списание?

    Каждый запрос мерчанта несёт ключ идемпотентности, и повтор возвращает уже созданный платёж. Если банк не ответил, шлюз сначала выясняет статус операции и только потом решает, повторять ли её.

  • Что будет, если банк недоступен?

    Новые платежи уходят через другой подключённый банк. Операции, по которым ответа не было, остаются в ожидании и проверяются запросом статуса и сверкой.

  • Можно ли подключить банки другой страны?

    Да. Банк подключается отдельным адаптером, который переводит его протокол и коды ответов в единые статусы шлюза. Ядро, антифрод и панель при этом не меняются.

  • Как настраивается антифрод?

    Правилами и порогами скоринга: лимиты, частота попыток, повторяющиеся данные. Пороги подбираются на реальном потоке, чтобы не отсекать честных плательщиков.

Проект под NDA: в публичном тексте только то, что согласовал клиент. Детали внедрения расскажем в переписке.

Обсудим вашузадачу

Вам необязательно иметь чёткую задачу. Оставьте контакты, и мы разберём ваши текущие бизнес-процессы и честно покажем, где внедрение технологий даст реальный финансовый результат.

Связаться с нами

  • Свяжемся в течение дня
  • Подпишем NDA до обсуждения данных
  • Удобнее в мессенджере? Напишите в Telegram