Интеграция с ПО UPOS через библиотеку GATE. 1.0 Платформа Win32.

- Титульная страница
- Группы
- Структуры данных

Структуры данных | Макросы | Определения типов | Перечисления
Финансовые операции по картам
Примеры работы с библиотекой

## Структуры данных

struct | tag_struct_in_cl4
| Запрос на проведение финансовой операции Подробнее...
struct | tag_struct_out_cl4
| Ответ на проведение финансовой операции Подробнее...
struct | tagTGoodsData
| Структура для передачи товарной информации Подробнее...
struct | tag_struct_in_reserved4
| Дополнительные параметры запроса на проведение финансовой операции Подробнее...
struct | tag_struct_out_reserved4
| Опциональные параметры ответа на проведение финансовой операции Подробнее...

## Макросы

#define | SBER_OWN_CARD 'S'
| Признак принадлежности карты Сбербанку. Присутствует в последнем байте поля struct_out_cl4::CardName и struct_out_cl5::CardName.
#define | CARD_ISS_OTHER 0x00
| Карта выпущена сторонним банком. Используется в struct_out_reserved4::IsOwn и struct_out_reserved5::IsOwn.
#define | CARD_ISS_SBER 0x01
| Карта выпущена Сбербанком. Используется в struct_out_reserved4::IsOwn и struct_out_reserved5::IsOwn.
#define | CARD_ISS_SUBSIDIARY 0x02
| Карта выпущена дочерним банком Сбербанка. Используется в struct_out_reserved4::IsOwn и struct_out_reserved5::IsOwn.

## Определения типов

typedef struct tag_struct_in_cl4 | struct_in_cl4
| Запрос на проведение финансовой операции Подробнее...
typedef struct tag_struct_out_cl4 | struct_out_cl4
| Ответ на проведение финансовой операции Подробнее...
typedef struct tagTGoodsData | TGoodsData
| Структура для передачи товарной информации Подробнее...
typedef struct tag_struct_in_reserved4 | struct_in_reserved4
| Дополнительные параметры запроса на проведение финансовой операции Подробнее...
typedef struct tag_struct_out_reserved4 | struct_out_reserved4
| Опциональные параметры ответа на проведение финансовой операции Подробнее...

## Перечисления

enum | CARD_ENTRY_MODE { CARD_ENTRY_DEVICE = 'D', CARD_ENTRY_MANUAL = 'M', CARD_ENTRY_CHIP = 'C', CARD_ENTRY_FALLBACK = 'F',
CARD_ENTRY_VIVO_MS = 'R',
CARD_ENTRY_VIVO_EMV = 'E',
CARD_ENTRY_BY_ID = 'I'
}
| Тип считывания карты Подробнее...
enum | emvFormFactor { FFI_NONE = 0, FFI_CARD = 1, FFI_MINI = 2, FFI_WATCH = 3,
FFI_PHONE = 4,
FFI_TABLET = 5,
FFI_NONCARD = 6,
FFI_UNKNOWN = 7
}
| Форм фактор карты. Подробнее...

## Подробное описание

## Типы

typedef struct tag_struct_in_cl4 struct_in_cl4

Запрос на проведение финансовой операции

См. также
  Docs/Для разработчиков ПО ККМ/examples/gate.dll/cpp/functions-4000-5999

typedef struct tag_struct_in_reserved4 struct_in_reserved4

Дополнительные параметры запроса на проведение финансовой операции

См. также
  Docs/Для разработчиков ПО ККМ/examples/gate.dll/cpp/functions-4000-5999

typedef struct tag_struct_out_cl4 struct_out_cl4

Ответ на проведение финансовой операции

См. также
  Docs/Для разработчиков ПО ККМ/examples/gate.dll/cpp/functions-4000-5999

typedef struct tag_struct_out_reserved4 struct_out_reserved4

Опциональные параметры ответа на проведение финансовой операции

Поле struct_out_reserved4::TrxFlags принимает следующие значения.

Три младших бита младшего байта содержат способ чтения карты.

- 0 – магнитный ридер;
- 1 – ручной ввод номера карты;
- 2 - чиповый ридер;
- 3 - на карте есть чип, но она считана через магнитный ридер;
- 4 – бесконтактная карта с эмуляцией магнитной полосы;
- 5 – бесконтактная карта с эмуляцией чипа;
- 6 – введен идентификатор клиента.

остальные биты:

- 0x00008000L - Была проведена биоверификация держателя карты;
- 0x00010000L - Введен online pin;
- 0x00020000L - Введен offline pin;

- 0x00040000L - Операция без верификации держателя.

  См. также
    Docs/Для разработчиков ПО ККМ/examples/gate.dll/cpp/functions-4000-5999

typedef struct tagTGoodsData TGoodsData

Структура для передачи товарной информации

См. также
  Docs/Для разработчиков ПО ККМ/examples/gate.dll/cpp/functions-4000-5999

## Перечисления

enum CARD_ENTRY_MODE

Тип считывания карты

См. также
  Docs/Для разработчиков ПО ККМ/examples/gate.dll/cpp/functions-4000-5999

Элементы перечислений
CARD_ENTRY_MANUAL | Ручной ввод номера карты
CARD_ENTRY_CHIP | Считан чип карты
CARD_ENTRY_FALLBACK | Карта считана в режиме Fallback.
CARD_ENTRY_VIVO_MS | Карта считана бесконтактно
CARD_ENTRY_VIVO_EMV | Карта считана бесконтактно
CARD_ENTRY_BY_ID | Выполнен рекурентный платеж

enum emvFormFactor

Форм фактор карты.

Считывается с карты из определенного тега на карте. Тег не является обязательным и может отсутвовать. Обычно заполняется для бесконтактных устройств, таких как телефоны, часы и т.п. Значение определяет используемую технологию, а не конкретное средство оплаты, поэтому могут возникать ситуации, когда оплата выполнялась часами или браслетом, а признак указывает на телефон, к которому это устройство подключено.

Элементы перечислений
FFI_NONE | тег ffi отсутствует на карте
FFI_CARD | стандартная карта
FFI_MINI | карта в мини формате
FFI_WATCH | Key fobs, watches, wristbands, rings, and stickers.
FFI_PHONE | Cellular phones.
FFI_TABLET | Tablet or E-Book.
FFI_NONCARD | noncard form factor
FFI_UNKNOWN | Значение ffi считано с карты, но не распознано