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

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

PayBridge B2B работает в среде Docker на Linux и взаимодействует с тремя внешними участниками: системами банка, Национальной платёжной сетью (НПС) и торгово-сервисными предприятиями (ТСП).

Архитектура PayBridge B2B

Потоки данных

Номера соответствуют стрелкам на схеме.

№ Поток
1 ТСП создаёт платёжные ссылки и получает статусы через Merchant API (REST). Merchant API отправляет ТСП webhooks об оплате.
2 Интернет-банк передаёт исходящий платёж в Payment Service (REST). Payment Service отправляет интернет-банку webhooks о статусе.
3 Payment Service резервирует средства плательщика в АБС (REST, синхронно).
4 Payment Service передаёт платёж на отправку в NPS Connector.
5 NPS Connector обменивается сообщениями с НПС по ISO 20022 (pacs.008, pacs.002).
6 NPS Connector подписывает исходящие и проверяет подпись входящих сообщений через Crypto Service и СКЗИ банка.
7 NPS Connector публикует входящие платежи в NATS.
8 Incoming Gateway получает входящие платежи из NATS и публикует проводки на зачисление.
9 Incoming Gateway проверяет счёт получателя в АБС (REST, синхронно).
10 Payment Service публикует в NATS события статусов и проводки на списание.
11 АБС получает из NATS проводки на списание и зачисление (асинхронно).
12 Payment Service хранит платежи, Merchant API хранит платёжные ссылки в PostgreSQL.
13 Incoming Gateway уведомляет Merchant API об оплате ссылки.

С АБС PayBridge работает по двум каналам: синхронные запросы по REST (резервирование средств, проверка счёта) и асинхронные проводки через NATS (списание и зачисление).

Системы банка

Система Назначение
Интернет-банк для юридических лиц Интерфейс плательщика: открывает платёжную ссылку, подтверждает платёж, получает статус. Вызывает Payment Service по REST API.
АБС Автоматизированная банковская система: резервирует средства по запросу PayBridge, списывает и зачисляет их по проводкам.
СКЗИ Сертифицированное средство криптографической защиты информации банка. Подписывает исходящие сообщения в НПС и проверяет подпись входящих.

Компоненты PayBridge B2B

Компонент Назначение
Merchant API REST API для ТСП: создание платёжных ссылок и QR-кодов, получение статусов, возвраты.
Payment Service Ядро обработки исходящих платежей: проверяет реквизиты, резервирует средства в АБС, ведёт статус платежа.
Incoming Gateway Обрабатывает входящие платежи: проверяет счёт получателя и передаёт зачисление в АБС.
NPS Connector Обмен с НПС по ISO 20022 (pacs.008, pacs.002): формирует, отправляет и принимает сообщения.
Crypto Service Посредник между NPS Connector и СКЗИ банка: вызывает подпись и проверку подписи.
Шина сообщений (NATS) Асинхронный обмен: входящие платежи, события статусов, проводки в АБС.
PostgreSQL Хранение платежей, платёжных ссылок и журнала событий.

Масштабирование

Payment Service, Incoming Gateway и Merchant API не хранят состояние в памяти и масштабируются горизонтально: достаточно увеличить число реплик сервиса. NPS Connector запускается в одном экземпляре на каждый сертификат участника НПС.