Incoming Gateway¶
Incoming Gateway обрабатывает входящие B2B-платежи из НПС. Проверяет, что счёт получателя открыт в банке и активен, отвечает НПС и передаёт зачисление в АБС.
Как работает¶
- NPS Connector получает из НПС сообщение
pacs.008и публикует платёж в шину NATS. - Incoming Gateway получает платёж из NATS и проверяет счёт получателя в АБС по REST.
- Если счёт активен, шлюз подтверждает платёж, и NPS Connector отправляет в НПС
pacs.002со статусомACCP. Если счёт закрыт или не найден, шлюз отклоняет платёж с причинойAC04(счёт закрыт) илиAC01(неверный номер счёта). - После подтверждения шлюз публикует в NATS проводку на зачисление, и АБС зачисляет средства.
- Если платёж был оплатой по платёжной ссылке, шлюз уведомляет Merchant API, и ТСП получает webhook.
Подробная схема в разделе Входящий платёж.
Установка¶
Перед установкой должны работать NATS и NPS Connector (см. Структура решения). Incoming Gateway не принимает входящих HTTP-запросов, поэтому порт наружу не публикуется.
-
Добавьте сервис в
docker-compose.yml: -
Заполните файл
incoming-gateway.env(параметры в таблице ниже). -
Запустите сервис:
Параметры¶
| Параметр | Обязательный | Описание | Пример |
|---|---|---|---|
NATS_URL |
Да | Адрес сервера NATS. | nats://nats:4222 |
ABS_URL |
Да | Адрес API АБС для проверки счёта получателя. | https://abs.bank.local/api |
ACCOUNT_CHECK_TIMEOUT_SEC |
Нет | Время ожидания ответа АБС на проверку счёта. По умолчанию 5. |
5 |
LOG_LEVEL |
Нет | Уровень логирования. По умолчанию Information. |
Information |
Ограничение по времени
НПС ждёт ответа на входящий платёж не более 10 секунд. Значение ACCOUNT_CHECK_TIMEOUT_SEC должно оставлять запас на остальную обработку. Не устанавливайте его больше 7 секунд.
Проверка работоспособности¶
Эндпоинт состояния доступен только внутри контейнера:
Ожидаемый ответ:
Если одна из проверок возвращает Unhealthy, проверьте соответствующий параметр подключения и сетевой доступ (см. Сетевые доступы).