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

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

Группы | Структуры данных | Определения типов | Перечисления | Элементы перечислений | Функции | Переменные
Служебные операции pilot_nt.dll
Библиотека pilot_nt.dll

## Группы

| Функции чтения карт библиотеки pilot_nt.dll
| Вендинговые операции pilot_nt.dll
| Функции работы с контекстом pilot_nt.dll

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

struct | tag_struct_MerchantID_TeminalId
| Передается в качестве аргумента для получения MerchantID и TeminalId. Подробнее...

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

typedef struct tag_struct_MerchantID_TeminalId | struct_MerchantID_TeminalId

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

enum | ListFormat { IdWithComma =0 }

## Функции

PILOT_NT_API int | GetTerminalID (char *pTerminalID)
| Получить номер терминала как строку Подробнее...
PILOT_NT_API int | ServiceMenu (auth_answer *auth_answer)
| Открыть в техническое меню на пинпаде Подробнее...
PILOT_NT_API int | close_day (auth_answer *auth_answer)
| Закрытие дня. Подробнее...
PILOT_NT_API int | close_day_info (auth_answer *auth_answer, const char *iParams)
| Закрытие дня. Подробнее...
PILOT_NT_API int | get_statistics (auth_answer *auth_answer)
| Получение текущего отчета за текущую смену Подробнее...
PILOT_NT_API unsigned int | GetVer ()
| Получение номера версии библиотеки pilot_nt.dll. Подробнее...
PILOT_NT_API int | SetConfigData (const char *pConfData)
| Установить конфигурационные параметры в pinpad.ini. Подробнее...
PILOT_NT_API void | Done ()
| Деинициализация библиотеки pilot_nt.dll. Подробнее...
PILOT_NT_API int | EnableReader (HWND hDestWindow, UINT message)
| Асинхронное включение чтения карты Подробнее...
PILOT_NT_API int | DisableReader ()
| Асинхронное выключение чтения карты Подробнее...
PILOT_NT_API int | TestPinpad ()
| Проверка готовности пинпада Подробнее...
PILOT_NT_API int | SuspendTrx (DWORD dwAmount, char *pAuthCode)
| Функция переводит последнюю успешную транзакцию в «подвешенное» состояние. Если транзакция находится в этом состоянии, то при следующем сеансе связи с банком она будет отменена.. Подробнее...
PILOT_NT_API int | CommitTrx (DWORD dwAmount, char *pAuthCode)
| Функция возвращает последнюю успешную транзакцию в «нормальное» состояние. После этого транзакция будет включена в отчет и спроцессирована как успешная. Перевести ее снова в «подвешенное» состояние будет уже нельзя. Подробнее...
PILOT_NT_API int | RollbackTrx (DWORD dwAmount, char *pAuthCode)
| Функция вызывает немедленную отмену последней успешной операции Подробнее...
PILOT_NT_API int | AbortTransaction ()
| Функция прерывает работу функций card_authorizeX() Подробнее...
PILOT_NT_API int | AddMerchantCheque (DWORD dwQueryRequestID, const char *pCheque)
| Функция передает в терминал торговый чек Подробнее...
PILOT_NT_API int | AskCardHolderAbout (const char *question, char *answer, unsigned answerLength)
| Задать вопрос держателю карты и получить ответ введенный на клавиатуре пинпада. Подробнее...
PILOT_NT_API int | GetMerchantIdTerminalId (struct_MerchantID_TeminalId *MerchantID_TeminalId)
| Получение номера MerchantId и TetminalId pilot_nt.dll. Подробнее...
PILOT_NT_API WORD | GetLoyaltyList (ListFormat format, char *pDest, unsigned sz, unsigned *length)
| Получение списка программ лояльности. Данная функция запрашивает список лояльности из терминала и позволяет проверить, что программа с ожидаемым id есть в терминале. При успешной обработке запроса функция вернет код ошибки ERR_OK, запишет список лояльности в переданный массив байт и длину получившейся строки без учета завершающего ноля в параметр length. При успешной обработке запроса может вернуться длина списка равная нулю, в случае если список лояльности не был загружен в терминал. В случае если переданн массив байт недостаточного размера, функция вернет ошибку ERR_MORE_DATA и в параметре length вернет размер, необходимый для записи списка лольности. length указывает на размер без учета завершающего ноля. Подробнее...

## Переменные

int | TType
unsigned long | Amount
char | RCode [3]
char | AMessage [16]
int | CType
char * | Check
auth_answer | auth_answ
char | AuthCode [MAX_AUTHCODE]
auth_answer | auth_answ
char | AuthCode [MAX_AUTHCODE]
char | CardID [CARD_ID_LEN]
auth_answer | auth_answ
char | AuthCode [MAX_AUTHCODE]
char | CardID [CARD_ID_LEN]
int | ErrorCode
char | TransDate [TRANSDATE_LEN]
int | TransNumber
auth_answer | auth_answ
char | RRN [MAX_REFNUM]
char | AuthCode [MAX_AUTHCODE]
auth_answer | auth_answ
char | AuthCode [MAX_AUTHCODE]
char | CardID [CARD_ID_LEN]
int | ErrorCode
char | TransDate [TRANSDATE_LEN]
int | TransNumber
char | RRN [MAX_REFNUM]
DWORD | dwTag
char | Value [MAX_PAYMENT_ITEM]
BYTE | Flags
void * | pNextItem
auth_answer | auth_answ
char | AuthCode [MAX_AUTHCODE]
char | CardID [CARD_ID_LEN]
int | SberOwnCard
auth_answer | auth_answ
char | AuthCode [MAX_AUTHCODE]
char | CardID [CARD_ID_LEN]
int | ErrorCode
char | TransDate [TRANSDATE_LEN]
int | TransNumber
char | RRN [MAX_REFNUM]
char | EncryptedData [MAX_ENCR_DATA *2+1]
unsigned long | Amount
char | RRN [MAX_REFNUM]
char | Last4Digits [5]
unsigned short | ErrorCode
auth_answer | ans
char | AuthCode [MAX_AUTHCODE]
char | CardID [CARD_ID_LEN]
int | SberOwnCard
char | Hash [CARD_HASH_LEN]
auth_answer | ans
char | AuthCode [MAX_AUTHCODE]
char | CardID [CARD_ID_LEN]
int | ErrorCode
char | TransDate [TRANSDATE_LEN]
int | TransNumber
int | SberOwnCard
char | Hash [CARD_HASH_LEN]
auth_answer | ans
char | AuthCode [MAX_AUTHCODE]
char | CardID [CARD_ID_LEN]
int | ErrorCode
char | TransDate [TRANSDATE_LEN]
int | TransNumber
int | SberOwnCard
char | Hash [CARD_HASH_LEN]
char | Track3 [CARD_TRACK3_LEN]
unsigned long | RequestID
auth_answer | ans
char | AuthCode [MAX_AUTHCODE]
char | CardID [CARD_ID_LEN]
int | ErrorCode
char | TransDate [TRANSDATE_LEN]
int | TransNumber
int | SberOwnCard
char | Hash [CARD_HASH_LEN]
char | Track3 [CARD_TRACK3_LEN]
unsigned long | RequestID
DWORD | Department
char | RRN [MAX_REFNUM]
auth_answer | ans
char | AuthCode [MAX_AUTHCODE]
char | CardID [CARD_ID_LEN]
int | ErrorCode
char | TransDate [TRANSDATE_LEN]
int | TransNumber
int | SberOwnCard
char | Hash [CARD_HASH_LEN]
char | Track3 [CARD_TRACK3_LEN]
DWORD | RequestID
DWORD | Department
char | RRN [MAX_REFNUM]
DWORD | CurrencyCode
char | CardEntryMode
char | CardName [MAX_CARD_NAME_LEN]
char | AID [MAX_AID_ASCII_LEN]
char | FullErrorText [MAX_FULL_ERROR_TEXT]
auth_answer | ans
char | AuthCode [MAX_AUTHCODE]
char | CardID [CARD_ID_LEN]
int | ErrorCode
char | TransDate [TRANSDATE_LEN]
int | TransNumber
int | SberOwnCard
char | Hash [CARD_HASH_LEN]
char | Track3 [CARD_TRACK3_LEN]
DWORD | RequestID
DWORD | Department
char | RRN [MAX_REFNUM]
DWORD | CurrencyCode
char | CardEntryMode
char | CardName [MAX_CARD_NAME_LEN]
char | AID [MAX_AID_ASCII_LEN]
char | FullErrorText [MAX_FULL_ERROR_TEXT]
DWORD | GoodsPrice
DWORD | GoodsVolume
char | GoodsCode [MAX_GOODS_CODE+1]
char | GoodsName [MAX_GOODS_NAME]
DWORD | size
DWORD | MonState
DWORD | MonMessageType
char | MonMessage [MAX_MON_MSG]
DWORD | size
DWORD | RequestId
DWORD | size
char * | Cheque
char | TermNum [MAX_TERMID]
| номер терминала
char | MerchNum [MAX_MERCHANT_LN+1]
| номер мерчанта

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

## Функции

PILOT_NT_API int AbortTransaction | ( |  | ) |

Функция прерывает работу функций card_authorizeX()

Заметки
  Внешнее ПО может вызвать эту функцию из отдельного треда, чтобы досрочно прекратить выполнение любой из функций card_authorize…(). При этом функция card_authorize…() завершится с кодом ошибки 2000 (операция прервана).

Возвращает
  int Код ошибки.

PILOT_NT_API int AddMerchantCheque | ( | DWORD | dwQueryRequestID,
|  | const char * | pCheque
| ) |  |

Функция передает в терминал торговый чек

Заметки
  Максимальный размер торгового чека 62 КБ. Описание в разделе Отправка торгового чека в банк

Аргументы

  dwQueryRequestID | Уникальный идентификатор операции (requestID в ответе финансовой операции)
  pCheque | Указатель на строку с торговым чеком

Предупреждения
  Используется только в торговых решениях PCI DSS.

Возвращает
  int Код ошибки.

PILOT_NT_API int AskCardHolderAbout | ( | const char * | question,
|  | char * | answer,
|  | unsigned | answerLength
| ) |  |

Задать вопрос держателю карты и получить ответ введенный на клавиатуре пинпада.

Заметки
  Вместо вопроса может использоваться предопределенное значение "phone" для ввода телефонного номера или "email" для ввода адреса электронной почты.

Аргументы

  [in] | question | Вопрос, либо предопреденное значение.
  [in,out] | answer | Ответ владельца карты. Для предопределенных значений может содержать значение по умолчанию, которое будет предложено для редактирования.
  [in] | answerLength | Длина буфера для ответа. Ответ пользователя копируется в аргумент answer функцией strncpy, поэтому завершающего ноля может и не быть.

Возвращает
  int Код ошибки.

PILOT_NT_API int close_day | ( | auth_answer * | auth_answer | ) |

Закрытие дня.

Заметки
  Поля TType, Amount, CType заполнять не нужно.

Аргументы

  [in,out] | auth_answer | см. auth_answer

Возвращает
  int Код ошибки.

PILOT_NT_API int close_day_info | ( | auth_answer * | auth_answer,
|  | const char * | iParams
| ) |  |

Закрытие дня.

Заметки
  Поля auth_answer::Amount, auth_answer::CType и auth_answer::TType заполнять не нужно. После выполнения функции поле auth_answer::Cheque может cодержать образ отчета по картам. Если значение поля не NULL, вызывающая программа должна напечатать возвращенный образ чека, а затем освободить вызовом функции GlobalFree().

Аргументы

  [in,out] | auth_answer | см. auth_answer
  [in,out] | iParams | Дополнительная информация для передачи на хост Сбербанка (например, о наличном обороте кассы за смену). В текущей версии поддерживается следующий формат строки: 1;число_оплат_за_наличные;сумма_оплат_за_наличные;номер кассовой смены Число 1 указывает, что следующие два параметра содержат количество наличных платежей и их сумму в копейках. Пример: «1;55;20010000;2334» - означает, что за смену было 55 оплат наличными на общую сумму 200100.00 руб, номер кассовой смены 2334. Параметр номер смены ккм используется для контроля уникальности, если в течении смены выполнялось несколько сверок итогов.

Возвращает
  int Код ошибки.

PILOT_NT_API int CommitTrx | ( | DWORD | dwAmount,
|  | char * | pAuthCode
| ) |  |

Функция возвращает последнюю успешную транзакцию в «нормальное» состояние. После этого транзакция будет включена в отчет и спроцессирована как успешная. Перевести ее снова в «подвешенное» состояние будет уже нельзя.

Заметки
  Функция сверяет переданные извне параметры (сумму и код авторизации) со значениями в последней успешной операции, которая была проведена через библиотеку. Если хотя бы один параметр не совпадает, функция возвращает код ошибки 4140 и не выполняет никаких действий.

Предупреждения
  Не поддерживается при работе по протоколу ТТК.

Аргументы

  dwAmount | Сумма операции (в копейках)
  pAuthCode | Код авторизации.

Возвращает
  int Код ошибки.

PILOT_NT_API int DisableReader | ( |  | ) |

Асинхронное выключение чтения карты

Возвращает
  int Код ошибки.

PILOT_NT_API void Done | ( |  | ) |

Деинициализация библиотеки pilot_nt.dll.

Заметки
  Выполняется отключение от библиотеки gate.dll

PILOT_NT_API int EnableReader | ( | HWND | hDestWindow,
|  | UINT | message
| ) |  |

Асинхронное включение чтения карты

Аргументы

  [in] | hDestWindow | Хендл окна, которое будет получать сообщения о чтении карты
  [in] | message | Идентификатор сообщение о чтении карты

Возвращает
  int Код ошибки.

PILOT_NT_API int get_statistics | ( | auth_answer * | auth_answer | ) |

Получение текущего отчета за текущую смену

Аргументы

  [in,out] | auth_answer | См. auth_answer. При значении поля TType = 0 формируется полный отчет, иначе - краткий

Возвращает
  int Код ошибки.

PILOT_NT_API WORD GetLoyaltyList | ( | ListFormat | format,
|  | char * | pDest,
|  | unsigned | sz,
|  | unsigned * | length
| ) |  |

Получение списка программ лояльности. Данная функция запрашивает список лояльности из терминала и позволяет проверить, что программа с ожидаемым id есть в терминале. При успешной обработке запроса функция вернет код ошибки ERR_OK, запишет список лояльности в переданный массив байт и длину получившейся строки без учета завершающего ноля в параметр length. При успешной обработке запроса может вернуться длина списка равная нулю, в случае если список лояльности не был загружен в терминал. В случае если переданн массив байт недостаточного размера, функция вернет ошибку ERR_MORE_DATA и в параметре length вернет размер, необходимый для записи списка лольности. length указывает на размер без учета завершающего ноля.

Заметки
  Возвращается список значений "Номер программы лояльности для внешней системы" в том порядке, как он задан в настройках. Если значение "Номер программы лояльности для внешней системы" для какой-то программы не задано, но сама программа присутвует, в этой позиции списка вернется 0. Вопросы правильности настройки программ лояльности с нужным идентификатором должны решаться организационными мерами.

Аргументы

  format | формат в котором необходимо получить список лояльности.
  pDest | указатель "С" строку, в которую запишется список лояльности при успешно выполнном запросе. При ошибке ERR_MORE_DATA запишется sz-1 символ.
  sz | размер переданного массива байт.
  length | размер списка лояльности, полученного при успешной обработке запроса.

Возвращает
  int Код ошибки.

PILOT_NT_API int GetMerchantIdTerminalId | ( | struct_MerchantID_TeminalId * | MerchantID_TeminalId | ) |

Получение номера MerchantId и TetminalId pilot_nt.dll.

Аргументы

  MerchantID_TeminalId | указатель на структуру, типа tag_struct_MerchantID_TeminalId, куда функция запишит MerchantID и TeminalId, при успешном завершении.

Возвращает
  int Код ошибки.

PILOT_NT_API int GetTerminalID | ( | char * | pTerminalID | ) |

Получить номер терминала как строку

Заметки
  Функция не поддерживается по протоколу TTK для PCI-DSS решений.
  Функция возвращает номер терминала, заданный в разделе "Общие настройки", при отсутствии параметра (номера терминалов только в отделах) будет возвращена ошибка 13.

Аргументы

  [out] | pTerminalID | Строковое представление номера терминала. 9 байт.

Возвращает
  int Код ошибки.

PILOT_NT_API unsigned int GetVer | ( |  | ) |

Получение номера версии библиотеки pilot_nt.dll.

Возвращает
  Версия как целое число в формате 0x00VVRRBB. VV - версия, RR - релиз, BB - сборка

PILOT_NT_API int RollbackTrx | ( | DWORD | dwAmount,
|  | char * | pAuthCode
| ) |  |

Функция вызывает немедленную отмену последней успешной операции

Заметки
  Операция может быть предварительно возможно, ранее переведенную в «подвешенное» состояние, хотя это и не обязательно). Если транзакция уже была возвращена в «нормальное» состояние функцией CommitTrx(), то функция RollbackTrx() завершится с кодом ошибки 4141, не выполняя никаких действий. Функция сверяет переданные извне параметры (сумму и код авторизации) со значениями в последней успешной операции, которая была проведена через библиотеку. Если хотя бы одинпараметр не совпадает, функция возвращает код ошибки 4140 и не выполняет никаких действий.

Предупреждения
  Не поддерживается при работе по протоколу ТТК.

Аргументы

  dwAmount | Сумма операции (в копейках)
  pAuthCode | Код авторизации.

Возвращает
  int Код ошибки.

PILOT_NT_API int ServiceMenu | ( | auth_answer * | auth_answer | ) |

Открыть в техническое меню на пинпаде

Заметки
  По завершении поле auth_answer.Check может содержать образ документа для печати.

Аргументы

  [out] | auth_answer | Буфер результата операции

Возвращает
  int Код ошибки.

PILOT_NT_API int SetConfigData | ( | const char * | pConfData | ) |

Установить конфигурационные параметры в pinpad.ini.

Аргументы

  [in] | pConfData | Строка формата param1=value1;...paramN=valueN;

Возвращает
  int Код ошибки.

PILOT_NT_API int SuspendTrx | ( | DWORD | dwAmount,
|  | char * | pAuthCode
| ) |  |

Функция переводит последнюю успешную транзакцию в «подвешенное» состояние. Если транзакция находится в этом состоянии, то при следующем сеансе связи с банком она будет отменена..

Заметки
  Функция сверяет переданные извне параметры (сумму и код авторизации) со значениями в последней успешной операции, которая была проведена через библиотеку. Если хотя бы один параметр не совпадает, функция возвращает код ошибки 4140 и не выполняет никаких действий.

Предупреждения
  Не поддерживается при работе по протоколу ТТК.

Аргументы

  dwAmount | Сумма операции (в копейках)
  pAuthCode | Код авторизации.

Возвращает
  int Код ошибки.

PILOT_NT_API int TestPinpad | ( |  | ) |

Проверка готовности пинпада

Заметки
  Функция проверяет наличие пинпада. При успешном выполнении возвращает 0 (пинпад подключен), при неудачном – код ошибки (пинпад не подключен или неисправен).

Возвращает
  int Код ошибки.

## Переменные

char AID[MAX_AID_ASCII_LEN]

[out] Application ID чиповой карты (в виде ASCIIZ-строки)

char AID[MAX_AID_ASCII_LEN]

[out] Application ID чиповой карты (в виде ASCIIZ-строки). Не используется для PCI-DSS решений

char AMessage[16]

[out] текст результата авторизации

unsigned long Amount

[in] сумма в копейках

unsigned long Amount

[in] сумма в копейках

auth_answer ans

[in, out] Основные параметры операции. См. auth_answer

auth_answer ans

[in, out] Основные параметры операции. См. auth_answer

auth_answer ans

[in, out] Основные параметры операции. См. auth_answer

auth_answer ans

[in, out] Основные параметры операции. См. auth_answer

auth_answer ans

[in, out] Основные параметры операции. См. auth_answer

auth_answer ans

[in, out] Основные параметры операции. См. auth_answer

auth_answer auth_answ

[in] Основные параметры операции. См. auth_answer

auth_answer auth_answ

[in, out] Основные параметры операции. См. auth_answer

auth_answer auth_answ

[in, out] Основные параметры операции. См. auth_answer

auth_answer auth_answ

[in] Основные параметры операции. См. auth_answer

auth_answer auth_answ

[in, out] Основные параметры операции. См. auth_answer

auth_answer auth_answ

[in, out] Основные параметры операции. См. auth_answer

auth_answer auth_answ

[in, out] Основные параметры операции. См. auth_answer

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char AuthCode[MAX_AUTHCODE]

[out] Код авторизации. 7 байт.

char CardEntryMode

[out] Способ чтения карты ('D'-магн.полоса, 'M'-ручной ввод, 'C'-чип, 'E'-бесконтакт EMV, 'R'-бесконтакт magstripe, 'F'-fallback)

char CardEntryMode

[out] Способ чтения карты ('D'-магн.полоса, 'M'-ручной ввод, 'C'-чип, 'E'-бесконтакт EMV, 'R'-бесконтакт magstripe, 'F'-fallback)

char CardID[CARD_ID_LEN]

[out] Идентификатор карты. 25 байт. Для международных карт все символы, кроме первых 6 и последних 4, будут заменены символами ‘*’.

char CardID[CARD_ID_LEN]

[out] Идентификатор карты. 25 байт.

char CardID[CARD_ID_LEN]

[out] Идентификатор карты. 25 байт.

char CardID[CARD_ID_LEN]

[out] Идентификатор карты. 25 байт.

char CardID[CARD_ID_LEN]

[out] Идентификатор карты. 25 байт.

char CardID[CARD_ID_LEN]

[out] Идентификатор карты. 25 байт.

char CardID[CARD_ID_LEN]

[out] Идентификатор карты. 25 байт. Для международных карт все символы, кроме первых 6 и последних 4, будут заменены символами ‘*’.

char CardID[CARD_ID_LEN]

[out] Идентификатор карты. 25 байт. Для международных карт все символы, кроме первых 6 и последних 4, будут заменены символами ‘*’.

char CardID[CARD_ID_LEN]

[out] Идентификатор карты. 25 байт. Для международных карт все символы, кроме первых 6 и последних 4, будут заменены символами ‘*’.

char CardID[CARD_ID_LEN]

[out] Идентификатор карты. 25 байт. Для международных карт все символы, кроме первых 6 и последних 4, будут заменены символами ‘*’.

char CardID[CARD_ID_LEN]

[out] Идентификатор карты. 25 байт. Для международных карт все символы, кроме первых 6 и последних 4, будут заменены символами ‘*’.

char CardName[MAX_CARD_NAME_LEN]

[out] Название типа карты

char CardName[MAX_CARD_NAME_LEN]

[out] Название типа карты

char* Check

[out] образ чека, должен освобождаться GlobalFree в вызывающей программе

char* Cheque

[out] Чек исходной операции

int CType

[in,out] тип карты

DWORD CurrencyCode

[in] Международный код валюты (810, 643, 840, 978 и т.д.)

DWORD CurrencyCode

[in] Международный код валюты (810, 643, 840, 978 и т.д.)

DWORD Department

[in] Порядковый номер отдела от 0 до 14-ти, включительно. При установке номера отдела в 0xFFFFFFFF, номер отдела будет запрошен через интерфейс терминала после вставки карты. Если номер отдела будет указан вне настроенного диапазона, то терминал вернет код ошибки 4191.

DWORD Department

[in] Порядковый номер отдела от 0 до 14-ти, включительно. При установке номера отдела в 0xFFFFFFFF, номер отдела будет запрошен через интерфейс терминала после вставки карты. Если номер отдела будет указан вне настроенного диапазона, то терминал вернет код ошибки 4191.

DWORD Department

[in] Порядковый номер отдела от 0 до 14-ти, включительно. При установке номера отдела в 0xFFFFFFFF, номер отдела будет запрошен через интерфейс терминала после вставки карты. Если номер отдела будет указан вне настроенного диапазона, то терминал вернет код ошибки 4191.

DWORD dwTag

Тег платежной системы.

char EncryptedData[MAX_ENCR_DATA *2+1]

[in, out] шифрованный номер карты и срок действия. Строка.

int ErrorCode

[out] Код ошибки.

int ErrorCode

[out] Код ошибки.

int ErrorCode

[out] Код ошибки.

unsigned short ErrorCode

[out] Код ошибки.

int ErrorCode

[out] Код ошибки.

int ErrorCode

[out] Код ошибки.

int ErrorCode

[out] Код ошибки.

int ErrorCode

[out] Код ошибки.

int ErrorCode

[out] Код ошибки.

BYTE Flags

must be 0x40 for immediate sending

char FullErrorText[MAX_FULL_ERROR_TEXT]

[out] Полный текст сообщения об ошибке

char FullErrorText[MAX_FULL_ERROR_TEXT]

[out] Полный текст сообщения об ошибке

char GoodsCode[MAX_GOODS_CODE+1]

[in] Код товара во внешней системе.

char GoodsName[MAX_GOODS_NAME]

[in] Наименование товара во внешней системе. Внимание! В структуре auth_answer14 название товара на один символ короче чем в gate.dll TGoodsData. Зафиксируем эту ошибку как стандарт

DWORD GoodsPrice

[in] Цена за единицу товара, коп (34.99->3499)

DWORD GoodsVolume

[in] Количество товара, в тыс. долях (30.234->30234)

char Hash[CARD_HASH_LEN]

[in, out] хеш SHA1 от номера карты, в формате ASCII с нулевым байтом в конце. 40 байт.

char Hash[CARD_HASH_LEN]

[in, out] хеш от номера карты, в формате ASCII с нулевым байтом в конце

char Hash[CARD_HASH_LEN]

[in, out] хеш SHA1 от номера карты, в формате ASCII с нулевым байтом в конце. 40 байт.

char Hash[CARD_HASH_LEN]

[in, out] хеш SHA1 от номера карты, в формате ASCII с нулевым байтом в конце. 40 байт.

char Hash[CARD_HASH_LEN]

[in, out] хеш SHA1 от номера карты, в формате ASCII с нулевым байтом в конце. 40 байт.

char Hash[CARD_HASH_LEN]

[in, out] хеш SHA1 от номера карты, в формате ASCII с нулевым байтом в конце. 40 байт.

char Last4Digits[5]

[in] последние 4 цифры номера карты

char MonMessage[MAX_MON_MSG]

[out] Текст сообщения

DWORD MonMessageType

[out] Тип

DWORD MonState

[out] Статус

void* pNextItem

Следующий элемент цепочки. В случае NULL, это последний элемент цепочки.

char RCode[3]

[out] двузначный код результата авторизации. Значение 00 означает успех операции, 01-98 - полученные от хоста ошибки авторизации, 99 - все остальные ошибки, в том числе возникшие локально и не свзанные с ответами хоста.

unsigned long RequestID

[in,out] Уникальный номер операции. Только PCI DSS решения.

unsigned long RequestID

[in,out] Уникальный номер операции. Только PCI DSS решения.

DWORD RequestID

[in,out] Уникальный номер операции. Только PCI DSS решения.

DWORD RequestID

[in,out] Уникальный номер операции. Только PCI DSS решения.

DWORD RequestId

[out] Статус операции RequestId

char RRN[MAX_REFNUM]

[in,out] Номер ссылки операции, присвоенный хостом. Используется для операций возврат и множественной авторизации. Содержит уникальный 12-значный ссылочный номер. При предавторизации это поле является выходным (его заполняет библиотека pilot_nt.dll), а при завершении расчета – входным (значение должно быть заполнено вызывающей программой; оно должно совпадать со значением, возвращенным при предавторизации).

char RRN[MAX_REFNUM]

[in,out] Номер ссылки операции, присвоенный хостом. Используется для операций возврат и множественной авторизации. Содержит уникальный 12-значный ссылочный номер. При предавторизации это поле является выходным (его заполняет библиотека pilot_nt.dll), а при завершении расчета – входным (значение должно быть заполнено вызывающей программой; оно должно совпадать со значением, возвращенным при предавторизации).

char RRN[MAX_REFNUM]

[in,out] Номер ссылки операции, присвоенный хостом. Используется для операций возврат и множественной авторизации. Содержит уникальный 12-значный ссылочный номер. При предавторизации это поле является выходным (его заполняет библиотека pilot_nt.dll), а при завершении расчета – входным (значение должно быть заполнено вызывающей программой; оно должно совпадать со значением, возвращенным при предавторизации).

char RRN[MAX_REFNUM]

[in,out] Номер ссылки операции, присвоенный хостом. Используется для операций возврат и множественной авторизации. Содержит уникальный 12-значный ссылочный номер. При предавторизации это поле является выходным (его заполняет библиотека pilot_nt.dll), а при завершении расчета – входным (значение должно быть заполнено вызывающей программой; оно должно совпадать со значением, возвращенным при предавторизации).

char RRN[MAX_REFNUM]

[in,out] Номер ссылки операции, присвоенный хостом. Используется для операций возврат и множественной авторизации. Содержит уникальный 12-значный ссылочный номер. При предавторизации это поле является выходным (его заполняет библиотека pilot_nt.dll), а при завершении расчета – входным (значение должно быть заполнено вызывающей программой; оно должно совпадать со значением, возвращенным при предавторизации).

char RRN[MAX_REFNUM]

[in,out] Номер ссылки операции, присвоенный хостом. Используется для операций возврат и множественной авторизации. Содержит уникальный 12-значный ссылочный номер. При предавторизации это поле является выходным (его заполняет библиотека pilot_nt.dll), а при завершении расчета – входным (значение должно быть заполнено вызывающей программой; оно должно совпадать со значением, возвращенным при предавторизации).

char RRN[MAX_REFNUM]

[in,out] Номер ссылки операции, присвоенный хостом. Используется для операций возврат, множественной авторизации и завершения расчета. Содержит уникальный 12-значный ссылочный номер. При предавторизации это поле является выходным (его заполняет библиотека pilot_nt.dll), а при завершении расчета – входным (значение должно быть заполнено вызывающей программой; оно должно совпадать со значением, возвращенным при предавторизации).

int SberOwnCard

[out] Флаг принадлежности карты Сбербанку

int SberOwnCard

[out] Флаг принадлежности карты Сбербанку

int SberOwnCard

[out] Флаг принадлежности карты Сбербанку

int SberOwnCard

[out] Флаг принадлежности карты Сбербанку

int SberOwnCard

[out] Флаг принадлежности карты Сбербанку

int SberOwnCard

[out] Флаг принадлежности карты Сбербанку

int SberOwnCard

[out] Флаг принадлежности карты Сбербанку

DWORD size

[out] Размер?

DWORD size

[out] Размер

DWORD size

[out] Размер

char Track3[CARD_TRACK3_LEN]

[out] Третья дорожка карты. В PCI DSS решениях содержит данные с карты лояльности

char Track3[CARD_TRACK3_LEN]

[out] третья дорожка карты. В PCI DSS решениях содержит данные с карты лояльности

char Track3[CARD_TRACK3_LEN]

[out] третья дорожка карты. В PCI DSS решениях содержит данные с карты лояльности

char Track3[CARD_TRACK3_LEN]

[out] третья дорожка карты. В PCI DSS решениях содержит данные с карты лояльности

char TransDate[TRANSDATE_LEN]

[out] Дата и время операции

char TransDate[TRANSDATE_LEN]

[out] Дата и время операции

char TransDate[TRANSDATE_LEN]

[out] Дата и время операции

char TransDate[TRANSDATE_LEN]

[out] Дата и время операции

char TransDate[TRANSDATE_LEN]

[out] Дата и время операции

char TransDate[TRANSDATE_LEN]

[out] Дата и время операции

char TransDate[TRANSDATE_LEN]

[out] Дата и время операции

char TransDate[TRANSDATE_LEN]

[out] Дата и время операции

int TransNumber

[out] Номер операции за опер. день, см. номер на чеке

int TransNumber

[out] Номер операции за опер. день, см. номер на чеке

int TransNumber

[out] Номер операции за опер. день, см. номер на чеке

int TransNumber

[out] Номер операции за опер. день, см. номер на чеке

int TransNumber

[out] Номер операции за опер. день, см. номер на чеке

int TransNumber

[out] Номер операции за опер. день, см. номер на чеке

int TransNumber

[out] Номер операции за опер. день, см. номер на чеке

int TransNumber

[out] Номер операции за опер. день, см. номер на чеке

int TType

[in] тип операции. см ::OpetationTypes

char Value[MAX_PAYMENT_ITEM]

Значение тэга платежной системы. 128 байт. ::MAX_PAYMENT_ITEM