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

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

Функции
Функции чтения карт библиотеки pilot_nt.dll
Библиотека pilot_nt.dll » Служебные операции pilot_nt.dll

## Функции

PILOT_NT_API int | ReadCard (char *Last4Digits, char *Hash)
| Чтение карты. Подробнее...
PILOT_NT_API int | ReadCardSB (char *Last4Digits, char *Hash)
| Функция позволяет прочитать банковскую карту для использования в скидочной системе «Спасибо от Сбербанка». Подробнее...
PILOT_NT_API int | ReadCardWithType (char *Last4Digits, char *Hash, int *pCardType, int *pIsOwnCard)
| Чтение карты Подробнее...
PILOT_NT_API int | ReadMaskedCardWithType (char *PAN, char *Hash, int *pCardType, int *pIsOwnCard)
| Чтение карты Подробнее...
PILOT_NT_API int | ReadTrack2 (char *Track2)
| Чтение полной второй дорожки карты Подробнее...
PILOT_NT_API int | ReadCardTrack3 (char *Last4Digits, char *Hash, char *pTrack3)
| Чтение полной третьей дорожки карты Подробнее...
PILOT_NT_API int | ReadSbercard (char *CardNo, char *ClientName)
| Чтение карты Сберкарт Подробнее...
PILOT_NT_API int | ReadCardAndName (char *pTrack2, char *ValidThru, char *pName)
| Чтение карты Подробнее...
PILOT_NT_API int | ReadCardFull (char *CardNo, char *ValidThru)
| Чтение карты Подробнее...
PILOT_NT_API int | ReadCardContext (CONTEXT_PTR dataOut)
| Чтение карты Если требуется чтение нестандартных карт, например карт лояльности на базе Mifare или Google VAS, в контекст операции должен быть передан соответсвующий тип карты. Подробнее...

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

Семейство функций "Чтение карты" предназначено для получения реквизитов карты без списания денежных средств. Чтобы избежать повторного считывания карты после вызова функций "чтение карты" операция может быть продолжена путем вызова функции card_authorizeX и передачи хэша в аргументе track2. Если карта была считана бесконтактным образом, терминал потребует еще раз париложить карту, т.к. на момент первого чтения карты не были известны сумма и валюта операции, которые являются критичными для проведения операции по бесконтактной карте. Данные функции являются устаревшими и не должны использоваться. Для получения реквизитов операции должен использоваться механизм возврата промежуточного кода ошибки 4353.

## Функции

PILOT_NT_API int ReadCard | ( | char * | Last4Digits,
|  | char * | Hash
| ) |  |

Чтение карты.

Заметки
  Возвращеный хэш не может использоваться для проведения операции в PCI-DSS решениях. Функция возвращает первые 24 символа от строкового представления хэш добавляя 'H' в начале. По это причине функция не может использоваться в PCI-DSS решениях.

См. также
  Docs\Для разработчиков ПО ККМ\examples\pilot_nt.dll\cpp\readcard

Аргументы

  Last4Digits | Буфер, куда функция записывает четыре последних цифры номера карты. Размер буфера должен быть не менее 5 байт.
  Hash | Хеш от номера карты, в формате ASCII с нулевым байтом в конце и первым символом 'H'. Возврщается первые 12 байт хэш (24 символа ascii + 'H'). Размер буфера должен быть не менее 26 байт.

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

PILOT_NT_API int ReadCardAndName | ( | char * | pTrack2,
|  | char * | ValidThru,
|  | char * | pName
| ) |  |

Чтение карты

Заметки
  Фамилия клиента не возвращается для PCI-DSS решений.

Аргументы

  [out] | pTrack2 | Track2
  [out] | ValidThru | Срок действия карты в формате YYMM
  [out] | pName | имя фамилия клиента эмброссированные на карте.

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

PILOT_NT_API int ReadCardContext | ( | CONTEXT_PTR | dataOut | ) |

Чтение карты Если требуется чтение нестандартных карт, например карт лояльности на базе Mifare или Google VAS, в контекст операции должен быть передан соответсвующий тип карты.

См. также
  CardTypes

Аргументы

  dataOut | Контекст операции, в которую копируются pan, хэш, тип карты, признак "Карта выпущена Сбербанком", номер программы лояльности, признаки считывания VAS и т.п.

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

PILOT_NT_API int ReadCardFull | ( | char * | CardNo,
|  | char * | ValidThru
| ) |  |

Чтение карты

Заметки
  Чтобы использовать результат для авторизации, их нужно будет сформатировать так "CardNo=ValidThru".
  Функция не поддерживается по протоколу TTK для PCI-DSS решений.
  PCI-DSS решения возращают маскированный номер карты.

Аргументы

  CardNo | Номер карты. Может иметь длину от 13 до 19 цифр.
  ValidThru | Срок действия карты в формате YYMM

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

PILOT_NT_API int ReadCardSB | ( | char * | Last4Digits,
|  | char * | Hash
| ) |  |

Функция позволяет прочитать банковскую карту для использования в скидочной системе «Спасибо от Сбербанка».

Заметки
  Карта должна быть выдана Сбербанком, в противном случае функция вернет ошибку 4180.

Аргументы

  Last4Digits | Буфер, куда функция записывает четыре последних цифры номера карты. Размер буфера должен быть не менее 5 байт.
  Hash | Хеш от номера карты, в формате ASCII с нулевым байтом в конце и первым символом 'H'. Размер буфера должен быть не менее 42 байта.

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

PILOT_NT_API int ReadCardTrack3 | ( | char * | Last4Digits,
|  | char * | Hash,
|  | char * | pTrack3
| ) |  |

Чтение полной третьей дорожки карты

Заметки
  Данные третьей дорожки могут иметь длину до 109 символов.

Аргументы

  [out] | Last4Digits | 4 последние цифры карты
  [out] | Hash | Хеш от номера карты, в формате ASCII с нулевым байтом в конце и первым символом 'H'. Размер буфера должен быть не менее 42 байта.
  [out] | pTrack3 | третья дорожка карты

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

PILOT_NT_API int ReadCardWithType | ( | char * | Last4Digits,
|  | char * | Hash,
|  | int * | pCardType,
|  | int * | pIsOwnCard
| ) |  |

Чтение карты

Аргументы

  Last4Digits | Буфер, куда функция записывает четыре последних цифры номера карты. Размер буфера должен быть не менее 5 байт.
  Hash | Хеш от номера карты, в формате ASCII с нулевым байтом в конце и первым символом 'H'. Размер буфера должен быть не менее 41 байта.
  pCardType | Тип карты. См. CardTypes
  pIsOwnCard | Признак "Карта выпущена Сбербанком"

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

PILOT_NT_API int ReadMaskedCardWithType | ( | char * | PAN,
|  | char * | Hash,
|  | int * | pCardType,
|  | int * | pIsOwnCard
| ) |  |

Чтение карты

Аргументы

  PAN | Буфер, куда функция записывает PAN карты
  Hash | Хеш от номера карты, в формате ASCII с нулевым байтом в конце и первым символом 'H'. Размер буфера должен быть не менее 42 байта.
  pCardType | Тип карты. См. CardTypes
  pIsOwnCard | Признак "Карта выпущена Сбербанком"

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

PILOT_NT_API int ReadSbercard | ( | char * | CardNo,
|  | char * | ClientName
| ) |  |

Чтение карты Сберкарт

Аргументы

  [out] | CardNo | полный номер карты. Для pci-dss решений возвращается маскированный номер.
  [out] | ClientName | имя фамилия клиента эмброссированные на карте

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

PILOT_NT_API int ReadTrack2 | ( | char * | Track2 | ) |

Чтение полной второй дорожки карты

Заметки
  Данные второй дорожки могут иметь длину до 40 символов. Вторая дорожка имеет формат: nnnn...nn=yymmddd...d где '=' - символ-разделитель nnn...n - номер карты yymm - срок действия карты (ГГММ) ddd...d - служебные данные карты PCI-DSS решения в аргументе Track2 возвращают маскированный номер карты.

Аргументы

  [out] | Track2 | Буфер на 41 байт.

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