Обмен данными между системой "ДБО BS-Client. Частный Клиент" v.2.5
и виртуальным POS-терминалом компании «Контакт-Дизайн»
Техническая спецификация
Версия 2.5.0.0
1. Аннотация
Настоящий документ содержит информацию, актуальную на момент его составления. не гарантирует отсутствия ошибок в данном документе. оставляет за собой право вносить изменения в документ без предварительного уведомления.
Документ является спецификацией интерфейсов обмена данными между информационными системами Дистанционного Банковского обслуживания «Частный клиент», далее ЧК, и виртуальным POS-терминал (далее ПЦ), выпущенный компанией «Контакт-Дизайн» и обеспечивающий взаимодействие с процессинговыми системами.
СОДЕРЖАНИЕ:
1. Аннотация. 2
2. 2. Общие положения. 4
2.1. Функциональные возможности. 4
2.2. Архитектура. 4
3. Настройка связки. 4
3.1. Настройка связки с ПЦ. 4
3.1.1. Настройка параметров связки с ПЦ. 4
3.1.2. Настройка обмена сообщениями. 5
3.2. Настройки на стороне ЧК. 6
3.2.1. Настройка обработчиков запросов. 6
3.2.2. Настройка автопроцедур выгрузки документов. 7
4. Функциональная спецификация. 9
4.1. Механизм выгрузки документов из ЧК в ПЦ. 9
4.1.1. Принцип выгрузки документов из системы ЧК в ПЦ и АБС. 9
4.1.2. Формат сообщений. 14
2. Общие положения
Виртуальный POS-терминал, выпущенный компанией «Контакт-Дизайн», уже сейчас обеспечивает взаимодействие со следующими процессинговыми системами: UCS, Компас+, OpenWay (Банка Москвы).
Для взаимодействия с виртуальным POS-терминал компанией «Контакт-Дизайн» предоставляется специальный программный модуль. Модуль представляет собой динамически подключаемую библиотеку DLL для Windows. Модуль поддерживает следующие операции:
- Списание средств с пластиковой карты;
- Зачисление средств на пластиковую карту;
2.1. Функциональные возможности
Связка с виртуальным POS-терминалом (ПЦ) поддерживает операции, в которых производится зачисление средств на карту клиента или списание средств с карты клиента:
· Перевод валюты;
· Перевод рублей (внешний);
· Перевод между картами и счетами;
· Перевод на карту другого клиента;
· Конверсия валют;
· Открытие депозита;
· Оплата услуг - при оплате услуг с пластиковой карты.
2.2. Архитектура
Взаимодействие Частного клиента (ЧК) с ПЦ производится через dll-библиотеку, например, scipbss. dll, которая поставляется Банку компанией Контакт Дизайн.
Обмен данными с ПЦ осуществляется с помощью запросов в текстовом формате. При проведении операций с участием банковских карт ЧК формирует запрос в текстовом формате для обращения к dll-библиотеке ПЦ.
Связка с ПЦ через dll-библиотеку осуществляется по общему принципу связи с учетными системами Банка, т. е. используя шлюзы связок с АБС. Уникальный идентификатор ПЦ в ЧК − связка №97 «C-Design».
Модуль связки с ПЦ выполняет выгрузку в ПЦ документов по операциям, перечисленным в п. 2.1., если при проведении данных операций использованы пластиковые карты.
3. Настройка связки
Настройка связи с ПЦ осуществляется на банковской части системы ЧК (cbank. exe) или модулем Построитель (dictman. exe).
3.1. Настройка связки с ПЦ
3.1.1. Настройка параметров связки с ПЦ
F Для настройки параметров связки с ПЦ запустите Построитель (dictman. exe), перейдите в раздел Конфигурации -> IFIZ
ð На экране появится диалог Настройка связки с АБС.
Рис. 3‑1 Построитель. Настройки связки с ПЦ
Конфигурационные параметры для настройки связки хранятся в ветке ABSAPI -> PC (Рис. 3‑1):
Наименование элемента | Описание |
DefaultPCType | Уникальный идентификатор связки с ПЦ. |
UsePC | Отключение/Подключение связки для выгрузки документов в ПЦ. |
3.1.2. Настройка обмена сообщениями
F Для настройки запроса к ПЦ «C-Design» необходимо настроить конфигурационные параметры. Запустите Построитель (dictman. exe), перейдите в раздел Конфигурации -> IFIZ
ð На экране появится диалог Настройка связки с АБС.
Рис. 3‑2 Построитель. Параметры связки с C-Design
Конфигурационные параметры для настройки запроса к ПЦ «C-Design» хранятся в ветке ABSAPI -> C-Design (Рис. 3‑2):
Наименование элемента | Описание |
COMPort | Идентификатор порта, к которому подключен POS-терминал с секретными данными. Значение параметра предоставляется компанией Контакт Дизайн. |
DocLoadLimAttempts | Максимальное количество подряд неуспешных выгрузок документа в ПЦ, например, при системных ошибках или ошибках связи. |
IPAddress | IP адрес ПЦ. Значение параметра предоставляется компанией Контакт Дизайн. |
IPPort | IP порт ПЦ. Значение параметра предоставляется компанией Контакт Дизайн. |
IPTO | Таймаут приема сообщения от ПЦ в секундах. Значение параметра предоставляется компанией Контакт Дизайн. |
LogSize | Размер внутреннего лога библиотеки. Изменение значения по умолчанию не рекомендуется. |
MerchN | Номер. Значение параметра предоставляется компанией Контакт Дизайн. |
ScipLibName | Название библиотеки ПЦ Контакт Дизайна. Значение параметра предоставляется компанией Контакт Дизайн. |
ScipStringSize | Максимальный размер строки запроса. Изменение значения по умолчанию не рекомендуется. |
TrmID | Номер POS терминала. Значение параметра предоставляется компанией Контакт Дизайн. Служит терминалом по умолчанию. Данная настройка может использоваться либо если у Банка нет разделения запросов по виртуальным POS-терминалам, либо если не было найдено соответствующее правило распределения в таблице TerminalPOS. |
3.2. Настройки на стороне ЧК
3.2.1. Настройка обработчиков запросов
F Необходимо прописать в настройках связки модули bll, обрабатывающие соответствующие запросы к ПЦ (связка № 91 «C-Design»). Для этого на банковской части системы ЧК (cbank. exe) выберите пункт меню Настройки à Настройки шлюза с АБС à Обработчики запросов к АБС….
ð При этом откроется список модулей запросов к УС (Рис. 3‑3)
Рис. 3‑3 Скроллер «Справочник логических модулей запросов к УС»
· Добавьте недостающие обработчики событий для связки № 97 «C-Design»:
Тип запроса | Описание | Библиотека |
BS_R_CARDACC | ПЕРЕВОД МЕЖДУ СЧЕТОМ И КАРТОЙ | axSCIPCac. bll |
BS_R_PAYCARD | ПЕРЕВОД НА КАРТУ ДРУГОГО КЛИЕНТА | axSCIPPCd. bll |
BS_R_CCONV | БЕЗНАЛИЧНАЯ КОНВЕРТАЦИЯ СРЕДСТВ | axSCIPCnv. bll |
BS_R_OPENDEPOSIT | ЗАПРОС НА ОТКРЫТИЕ ДЕПОЗИТА | axSCIPDep. bll |
BS_R_PDC | ПЛАТЕЖИ В ВАЛЮТЕ | axSCIPPdc. bll |
BS_R_PDR | ПЕРЕВОД РУБЛЕЙ ВНЕШНИЙ | axSCIPPdr. bll |
BS_R_PUPAY | ОПЛАТА УСЛУГ | axSCIPPup. bll |
3.2.2. Настройка автопроцедур выгрузки документов
Для обеспечения выгрузки в ПЦ документов по операциям, перечисленным в п. 2.1. необходимо изменить настройку типа запуска следующих автопроцедур:
· {Выгрузка} Платежи в валюте;
· {Выгрузка} Платежи в рублях;
· {Выгрузка} Переводы между картами/счетами;
· {Выгрузка} Конвертация валют;
· {Выгрузка} Единовременная оплата услуг;
· {Выгрузка} Обслуживание депозитов;
· {Выгрузка} Переводы на карту другого клиента.
F Для этого на банковской части системы ЧК (cbank. exe) выберите пункт меню Сервис à Автопроцедуры à Настройка автопроцедур…
ð На экране появится общий скроллер автопроцедур.
Рис. 3‑4 Скроллер «Схема автопроцедур»
F Для изменения существующих настроек автопроцедуры выделите ее в списке и нажмите на клавишу Enter или дважды щелкните левой кнопкой мыши на выбранной строке. Также можно воспользоваться кнопкой 
в панели инструментов диалогового окна.
ð При этом откроется диалоговое окно свойств автопроцедуры (Рис. 7‑12).
Рис. 3‑5 Диалоговое окно свойств автопроцедуры
· Измените типа запуска автопроцедуры. Для этого в поле «Тип запуска» выберите значение «Периодический»;
· Укажите период времени между запусками. Для этого нажмите кнопку «Изменить» и в открывшемся окне укажите период запуска автопроцедуры в секундах;
· Нажмите кнопку «Ок».
3.2.3. Настройка терминалов процессинга
В системе предусмотрена возможность разделить выгрузку запросов в POS-терминалы в соответствии со следующими пунктами:
· При существовании у Банка многофилиальной структуры возможность указания для каждого из филиалов номера POS-терминала;
· Возможность для каждого из типов карт указать свой номер POS-терминала;
· Возможность для каждого из типов направлений движения средств (пополнение/списание) указать свой POS-терминал.
Данные пункты можно также комбинировать между собой.
F Для этого на банковской части системы ЧК (cbank. exe) выберите пункт меню Справочники à Терминалы процессинга…
ð На экране появится общий скроллер терминалов.
Рис. 3‑6 Скроллер «Справочник терминалов ПЦ»
F Для создания нового терминала нажмите кнопку «Insert» или на иконку «
− Новый».
ð При этом откроется диалоговое окно (Рис. 3‑7).
Рис. 3‑7 Диалоговое окно терминалов процессинга
· Выберите тип «Головной Банк» или «Филиал»;
· При активной радиокнопке «Филиал», заполните БИК и наименование Банка, выбрав его из вызываемого справочника «Банки России»;
· Выберите «Тип карты» из справочника «Типы пластиковых карт» или активируйте метку «Все типы карт». При отметке галочкой чекбокса «Все типы карт», разделение запросов по POS-терминалам по типам карт не учитывается;
· Активируйте метку «Разделять по направлению платежей», если необходимо определить терминал дебета и терминал кредита;
· Заполните поле «Терминал» или поля «Терминал для дебета» и «Терминал для кредита», если активна метка «Разделять по направлению платежей»;
· Чекбокс «Разделять по направлению платежей» и либо одно поле для ввода терминала, либо 2 поля. Если отмечен чекбокс «Разделять по направлению платежей», то будут отображены 2 поля для ввода номер терминала – на пополнение и на списание, если не отмечен, то будет одно поле для ввода терминала;
· Нажмите кнопку «Ок».
4. Функциональная спецификация
Обмен данными между ЧК и ПЦ осуществляется с помощью запросов в текстовом формате.
4.1. Механизм выгрузки документов из ЧК в ПЦ
4.1.1. Принцип выгрузки документов из системы ЧК в ПЦ и АБС
Механизм выгрузки документов, перечисленных в разделе 2.1., из системы ЧК в АБС и ПЦ зависит от данных выгружаемого документа:
1. Перевод со счета на счет. Если по данным документа осуществляется перевод со счета на счет, т. е. перевод проводится без участия карт клиента, то документ выгружается только в АБС согласно следующей схеме:
2. Перевод с карты на карту. Если по данным документа осуществляется перевод с карты на карту, т. е. в переводе проводится списания с карты клиента и зачисление на карту клиента, то документ выгружается в АБС и ПЦ согласно следующей схеме:
3. Перевод со счета на карту. Если по данным документа осуществляется перевод со счета на карту, т. е. в переводе производится зачисление средств на карту клиента, то документ выгружается в АБС и ПЦ согласно следующей схеме:
4. Перевод с карты на счет. Если по данным документа осуществляется перевод с карты на счет, т. е. в переводе производится списания средств с карты клиента, то документ выгружается в АБС и ПЦ согласно следующей схеме:
5. Оплата услуг с пластиковой карты. Если осуществляется оплата услуг с пластиковой карты, то документ выгружается в АБС, ПС, ПЦ согласно следующей схеме:
4.1.2. Формат сообщений
Для обмена данными с ПЦ используется один формат сообщения.
ЧК формирует строку запроса для обращения к библиотеке ПЦ, в ответ ПЦ формирует такую же строку для передачи информации о результатах выгрузки операции. Формат строки запроса:
«StatusFlag;MsgN;EntryMode;CardNo;ExpDate;Track2Data;Amount;TransType;AuthCode;RRN;CCode;ReservedCode;ReservedTel;RespCode;TrmID;MerchN;IPAddress;IPPort;IPTO;COMPort;»
Описание параметров запроса (сообщения):
Наименование параметра | Размер | Входящие данные | Полученные данные |
StatusFlag | 1 | Должен быть пустым | A-успешная операция |
MsgN | 1-6 | Номер операции для процессинга, уникален в течении дня | Такое же значение, как и во входящих данных |
EntryMode | 1 | K-операция по номеру карты и дате окончания | Такое же значение, как и во входящих данных |
CardNo | До 19 | Если EntryMode=K | Номер Карты |
ExpDate | 4 | Если EntryMode=K | Дата окончания |
Track2Data | До 40 | Если EntryMode=R то должно содержать трек карты | Такое же значение, как и во входящих данных |
Amount | 4-13 | Сумма операции в формате #.## (1 Наличие точки и 2х знаков после запятой обязательно | Такое же значение, как и во входящих данных |
TransType | 1 | 0-операция списания/снятия | Такое же значение, как и во входящих данных |
AuthCode | 6 | Должен быть пустым | Если операция успешна то содержит значение кода авторизации процессинга |
RRN | 12 | Должен быть пустым | Если операция успешна то содержит значение кода RRN процессинга |
CCode | 4 | Код валюты (0810,0643) | Такое же значение, как и во входящих данных |
ReservedCode | Если TransType=W то содержит код оператора для оплаты | Такое же значение, как и во входящих данных | |
ReservedTel | Если TransType=W то содержит номер телефона/договора или иное значение предусмотренное форматом оператора | Такое же значение, как и во входящих данных | |
RespCode | 2 | Должен быть пустым | Содержит код ответа (цифровой-код ответа процессинга, символьный-код ошибки программы) |
TrmID | 8 | Номер POS терминала | Такое же значение, как и во входящих данных |
MerchN | До 15 | Номер | Такое же значение, как и во входящих данных |
IPAddress | 7-15 | IP адрес процессинга (192.168.0.1) | Такое же значение, как и во входящих данных |
IPPort | 4-6 | IP порт процессинга (1400) | Такое же значение, как и во входящих данных |
IPTO | 2 | Таймаут приема сообщения от процесинга в секундах (50) | Такое же значение, как и во входящих данных |
COMPort | От 4 | Если операция пополнения то содержит имя последовательного порта к которому подключен POS с секретными данными (COM2) | Такое же значение, как и во входящих данных |
