Payment Service¶
Payment Service обрабатывает исходящие B2B-платежи. Принимает платёж от интернет-банка, резервирует средства в АБС, передаёт платёж в НПС через NPS Connector и ведёт его статус до финального.
Перед установкой должны работать PostgreSQL, NATS и NPS Connector (см. Структура решения).
Установка¶
- Создайте пользователя базы данных с правами на схему
payments. -
Добавьте сервис в
docker-compose.yml: -
Положите в папку
certsTLS-сертификат и ключ сервиса (server.crt,server.key). Payment Service принимает запросы интернет-банка только по HTTPS на порту 8443. - Заполните файл
payment-service.env(параметры в таблице ниже). -
Запустите сервис:
Параметры¶
| Параметр | Обязательный | Описание | Пример |
|---|---|---|---|
DB_CONNECTION |
Да | Строка подключения к PostgreSQL. | Host=db;Database=paybridge;Username=pay |
NATS_URL |
Да | Адрес сервера NATS. | nats://nats:4222 |
ABS_URL |
Да | Адрес API АБС для резервирования средств. Списание выполняется проводкой через NATS. | https://abs.bank.local/api |
NPS_TIMEOUT_SEC |
Нет | Время ожидания ответа НПС, после которого платёж переходит в статус UNKNOWN. По умолчанию 30. |
30 |
WEBHOOK_RETRY_COUNT |
Нет | Число повторов отправки webhook в интернет-банк. По умолчанию 5. |
5 |
LOG_LEVEL |
Нет | Уровень логирования: Debug, Information, Warning, Error. По умолчанию Information. |
Information |
Секреты
Не храните пароли в payment-service.env в открытом виде в репозитории конфигурации. Передавайте их через Docker secrets или хранилище секретов банка.
Проверка работоспособности¶
Выполните запрос к эндпоинту состояния:
Ключ -k отключает проверку сертификата. Он нужен, если в тестовом контуре используется самоподписанный сертификат. В промышленном контуре выполняйте запрос без -k.
Ожидаемый ответ:
Если одна из проверок возвращает Unhealthy, проверьте соответствующий параметр подключения и сетевой доступ (см. Сетевые доступы).
Логи¶
Сервис пишет логи в stdout в формате JSON. Каждая запись о платеже содержит поле paymentId, по нему удобно искать всю историю обработки одного платежа: