TTK2 UPOS Extension 1.0 Этот документ является расширением описания протокола прикладного протокола TTK2. Протокола взаимодействия между приложением, запрашивающим выполнение операции (клиентом), и приложением, выполняющим операцию (сервером).

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

Запрос статуса операции
Примеры работы с библиотекой » Теги ТТК » Сервисные операции Примеры работы с библиотекой » | Теги ТТК

Предупреждения
  Внимание! Использование функционала запроса статуса операции обязательно для всех новых интеграций. Значение RequestID должно быть задано при запуске оплаты. Метод передачи внешнего RequestID описан в примерах интеграции для соответствующего модуля.
  Запрос статуса операции должен использовать значение RequestID, полученное после оплаты из возвращаемых результатов.
  Значение RequestID переданное при запуске оплаты может отличается от полученного после оплаты на версиях модулей ПО UPOS не поддерживающих внешний RequestID. В ответ кассовое программное обеспечение должно получить информацию об операции и чек выполненной операции (если такая найдена и не отменена).
  В случае ошибки при работе с чеком, либо его отсутствии по каким-либо техническим причинам, кассовое программное обеспечение может отменить операцию по её RequestID, пометив операцию к автоотмене. Алгоритм приведен ниже (см. Приостановить транзакцию).
  По операциям, отмененным автоматически, будет возвращена ошибка "Операция не найдена".

Применение
Запрос статуса операции применяется, когда результат выполнения операции неизвестен.
• При любой ошибке операции необходимо вызывать Запрос статуса операции, если при этом получена ошибка 4311 (операция не найдена), то операцию оплаты можно повторить, поскольку она не прошла успешно.
• На экран кассира следует выводить, только исходную ( полученную при финансовой операции) ошибку.
• Если Запрос статуса операции завершилась успешно, то касса должна считать чек из файла p, кассир может отдать чек клиенту, операция завершена так как описано в чеке (одобрена или отклонена).

Предупреждения
  Если операция завершилась ошибкой 99, это не значит, что транзакция была проведена неуспешно, а лишь то, что терминал не отвечает на команды. В этос случае необходимо приостановить работу и проверить канал связи ККМ и пинпада.

Схематично функционал использования Запрос статуса операции приведен в документе sb_pilot.doc раздел "Запрос статуса операции".

Заметки
  Пример проведения операции оплаты с установкой RequestID представлен по ссылке Уникальный идентификатор операции RequestID

Команда запроса статуса операции Для запроса статуса операции необходимо положить RequestID искомой операции в тег TAG_TTK_TRACK2 в виде текстовой строки.

Ссылка на описание | Значение | Тип | Длина | Пример значения
--- | --- | --- | --- | ---
TAG_TTK_CLIENT_MID | 0x00000001 | STRING | 3 | SRV
TAG_TTK_CLIENT_ECR | 0x00000002 | STRING | 12 | P02662392676
TAG_TTK_CLIENT_ERN | 0x00000003 | STRING | 10 | 2723297211
TAG_TTK_CLIENT_AMT | 0x00000004 | STRING | 12 | 000000000000
TAG_TTK_OPER_TYPE | 0x0000001A | STRING | 1 | B
TAG_TTK_DEPARTMENT_INDEX | 0x00005F02 | BINARY | 1 | 00
TAG_TTK_TRACK2 | 0x00000017 | STRING | 8 | 81704753
TAG_TTK_BUFFER_SIZE | 0x0000003E | STRING | 5 | 65000

Ответ на команду запроса статуса операции. Операция найдена.

Ссылка на описание | Значение | Тип | Длина | Пример значения
--- | --- | --- | --- | ---
TAG_TTK_SERVER_MID | 0x00000081 | STRING | 3 | SRV
TAG_TTK_SERVER_ECR | 0x00000082 | STRING | 12 | P02662392676
TAG_TTK_SERVER_ERN | 0x00000083 | STRING | 10 | 2723297211
TAG_TTK_SERVER_AUT_CODE | 0x0000008C | STRING | 6 | 95H691
TAG_TTK_SERVER_TSN | 0x0000008B | STRING | 6 | 000007
TAG_TTK_TERMINAL_ID | 0x0000009D | STRING | 8 | 00870006
TAG_TTK_MERCHANT_ID | 0x00000090 | STRING | 12 | 874444445555
TAG_TTK_PILOT_OPER_TYPE | 0x00005F07 | STRING | 3 | 001
TAG_TTK_CARD_TYPE | 0x00005F0D | BINARY | 1 | 03
TAG_TTK_SERVER_RRN | 0x00000098 | STRING | 12 | 154894648579
TAG_TTK_REQUEST_ID | 0x00005F0A | DWORD | 4 | 8176E7E5
TAG_TTK_TRX_FLAGS | 0x00005F0C | BINARY | 4 | 05000100
TAG_TTK_ENCDATA | 0x00005F39 | BINARY | 32 | E8532D9184D2BE849EDD74BA506C2C14D3F9E96B63B29B9836C814CFE79DAEB8
TAG_TTK_PAN | 0x00000089 | STRING | 16 | ************8943
TAG_TTK_CARD_EXPDATE | 0x00005F06 | STRING | 5 | 08/18
TAG_TTK_IS_OWN | 0x000000A4 | STRING | 1 | 1
TAG_TTK_LLT_ID | 0x00005F03 | STRING | 3 | 128
TAG_TTK_ISSUER_NAME | 0x0000008F | STRING | 4 | Visa
TAG_TTK_CLIENT_NAME | 0x00005F04 | STRING | 2 | /
TAG_TTK_SERVER_AMT | 0x00000084 | STRING | 12 | 000000123456
TAG_TTK_SERVER_AMT_C | 0x00005F33 | STRING | 12 | 000000123456
TAG_TTK_SERVER_DATE | 0x0000008D | STRING | 4 | 3101
TAG_TTK_SERVER_TIME | 0x0000008E | STRING | 4 | 1754
TAG_TTK_HASH | 0x000000A3 | STRING | 40 | E2C9F18F75F14C261BE1F8FAFCF92483D37EE566
TAG_TTK_CHEQUE_IN_ASCII | 0x0000009C | STRING | 646 | Магазин "Детский Мир"
TAG_TTK_APPROVE | 0x000000A1 | STRING | 1 | Y
TAG_TTK_RESPONSE_CODE | 0x0000009B | STRING | 2 | 00