Описание

Функциональность позволяет при оплате покупок через банковский терминал в Узбекистане передавать в фискальный регистратор номер банковской карты (в маскированном виде) и идентификатор транзакции платежа RRN/PPTID. Для внешних терминалов касса дополнительно показывает кассиру окно ввода этих параметров, а для интегрированных терминалов данные автоматически берутся из ответа процессингового центра.

Ценность

Передача номера карты и идентификатора транзакции обеспечивает соответствие требованиям законодательства Узбекистана к составу фискального чека. Кроме того, это упрощает разбор спорных ситуаций и проверку платежей, так как по сохранённым RRN и маскированному номеру карты можно быстро найти операцию в процессинговом центре.

Логика работы

Для банковских процессингов АРКУС2(Арком), UzCard(Tenge Bank), Humo(внешний и корпоративный) и Uzcard (внешний и корпаративный) используются следующий алогоритм работы:

В составе чека хранятся и передаются следующие значения:
- Идентификатор транзакции платежа;
- Номер карты в маскированном виде.
Форматы данных:
- Идентификатор транзакции платежа RRN "PPTID":
  - Тип данных: string.
  - Передаётся в фискальный регистратор FiscalDriveAPI в поле "PPTID".
  - Значение для интегрированный банковских терминалов требуется брать из ответа банковского процессинга: параметр RRN.
  - Значение для внешнего банковского терминала требуется брать из параметра введенного на кассе
- Номер карты "CardNumber":
  - Тип данных: string(16) - полная длина для хранения в системе.
  - Передаётся в фискальный регистратор FiscalDriveAPI в поле "CardNumber".
  - Значение для интегрированный банковских терминалов берется из ответа банковского процессинга: параметр номер карты.
  - Для внешних банковских терминалов для передачи во внешние системы и отображения происходит:
    - построение строки из первых 4 цифр, затем 8 *, затем последних 4 цифр.
      - Пример: введено "1234" и "5678" → сохраняется "1234********5678".

Пример работы

При продаже через внешний терминал Humo или Uzcard кассир выбирает безналичную оплату и тип карты.

В зависимости от настроек касса последовательно показывает окна ввода RRN и/или первых и последних 4 цифр номера карты, проверяет корректность введённых данных, формирует маскированный номер карты, сохраняет его вместе с RRN и типом карты и передаёт эти значения в фискализатор вместе с чеком.

Клавиатурная касса

Если "CardNumber": true.

Если "PPTID": true.

SetTouch

Если "CardNumber": true.

Если "PPTID": true.

Настройка

1. Выполните настройку типов безналичной оплаты на кассе для соответствующих банковских терминалов Узбекистана на сервере SetCentrum/SetRetail10:

Кассовый модуль → Банки → кнопка добавления процессинга →
- UzCard (один из типов: внешний или TengeBank).
- Humo.
Кассовый модуль → Шаблоны касс → [Шаблон кассы] → Процесс торговли → Настройки → Типы оплат → установите флажок напротив требуемого банковского процессинга

Поддерживаются банковские процессиги:

Humo (внешний);
UzСard (внешний);
Интегрированные сценарии:
1. АРКУС2 (Арком);
2. UzCard (Tenge Bank);
3. Humo (внешний и корпоративный);
4. Uzcard (внешний и корпоративный).

2. Настройте отображение окон ввода номера карты и RRN для внешних терминалов через конфигурационные файлы плагинов банковских процессингой (для касс POS/TOUCH): в конвигурационных файлах:

/home/tc/storagr/crystal-cash/config/plugins/bank-humo_external-config.xml
/home/tc/storagr/crystal-cash/config/config/plugins/bank-humo_juristic_external-config.xml
/home/tc/storagr/crystal-cash/config/config/plugins/bank-uzcard_external-config.xml
/home/tc/storagr/crystal-cash/config/config/plugins/bank-uzcard_juristic_external-config.xml

Параметры:

По умолчанию настройки отключены в значение false.

Установите значения в showCardInputDialog:
- true — показывать окно ввода номера карты (первые/последние 4 цифры);
- false — окно ввода номера карты не показывать;
Установите значения в showTransactionIdInputDialog:
- true — показывать окно ввода идентификатора транзакции RRN (PPTID);
- false — окно ввода RRN не показывать.

Пример:

<property key="showCardInputDialog" value="true"/>
<property key="showTransactionIdInputDialog" value="true"/>

3. Перезагрузите кассовый модуль.

Ограничения

Реализация функциональности только для клавиатурных касс и SetToouch.
Передача "CardNumber" и "PPTID" реализована для всех типов касс.
Функциональность реализована только для чека продажи.

Узбекистан ◾️ Передача и сохранения дополнительной информации при оплате банковским терминалом