¶ Общая информация
Для просмотра информации о транзакциях, проходящих через терминалы на КПП при оплатах с банковской карты, была сделана поддержка системы CallBack (при OFF-line списаниях при проходе через КПП)
Данный механизм позволяет:
- просматривать статусы транзакций, проходящих через конкретный терминал
- сверять фактические списания денежных средств со счетов клиентов с проходами через КПП, зарегистрированными в ПО Барс.
На текущий момент сделана поддержка механизма с процессингом от Расчетных Решений (РР) с использованием терминалом Vendotek Lite или Vendotek Full
¶ Требования к версиям ПО на объекте:
- Сервис Внешних Платежей (Bars.PaymentProcessing.Service) – не ниже 0.2.0.60
- Версия ПО Барс – минимум 161
- Версия kkserv - KKServ IMX v1.1.16
- Версия прошивки считывателя Vendotek - 1.37
- Версия прошивки контроллера (c3po) – минимум 1.4
¶ Настройка службы Внешних платежей
Для настройки Callback’ов необходимо настроить службу Внешних Платежей, предварительно прописав, путь до БД и порт в конфигурационном файле appsettings.json.
После запуска службы, проверяем, что в браузере по пути http://localhost:5008/index.html открывается страничка с запросами (Swagger).
- Настройка Барс.Администратор
Во вкладке «Внешние платежи – Эквайринги» необходимо добавить необходимый эквайринг.
Проверить, что служба доступна во вкладке «Сервис – Внутренние службы»
После этого, связываемся с представителем РР и просим подключить Callback’и по адресу: http://IP:port/api/CallBack/RaschetnyeResheniya
IP и порт прописываем своиТех. поддержка РР: трекер jira | +7(965) 4497430
В заявке указываем номера TID'ов на контроллерах, по которым хотим получать CallBack'и в Барс
ВАЖНО: Служба Bars.PaymentProcessing.Service должна быть доступа из внешней сети.
Для этого необходимо выделить либо белый IP-адрес на сервер, либо сделать процедуру проброса портов (по умолчанию служба прислушивается на порту 5008).
Если все сделано правильно, то по внешнему адресу отпкоется страница с запросами (Swagger).
Например: http://10.1.12.149:5008/index.html
Отслеживать платежи можно в «Барс.Администратор» во вкладке «Внешние платежи – Платежи»
После того, как придет Callback от РР (его можно увидеть, перейдя в уведомления), статус платежа перейдет в статус «Подтвержден»
В случае, если служба запущена и страница с запросами http://localhost:5008/index.html открывается, но в Барс.Администратор служба платежей недоступна,
скорее всего адрес не прописался в БД и его нужно прописать во вкладке
Сервис – Настройки – Внутренние службы
¶ Настройка Bars.Server
В настройках Bars.Server необходимо:
- установить галочку «BankCardPay принимать банковские карты»
- указать хост службы платежей и порт (по умолчанию 127.0.0.1:5008)
ВАЖНО: Хост службы платежей и порт могут быть внешними
(если BarsServer и Служба внешних платежей располагаются на разных машинах).
В этом случае необходимо прописывать реальный IP адрес машины, где запущена Служба внешних платежей