Структура предназначена для передачи ответа на запрос операции.
Атрибут | Обяз. | Тип | Комментарии |
status | M | ResponseStatus | Результат выполнения операции в ПЦ |
pcId | C | long (n..18) | Уникальный идентификатор транзакции, присвоенный ПЦ. Обязателен в случае положительного ответа на запрос авторизации и запрос возврата. |
cardInfo | O | массив CardInfoItem | Состояния элементов счета клиента. |
fmtCardInfo | O | массив FmtCardInfoItem | Состояния элементов счета клиента в форматированном (готовом к печати) виде. |
chequeMessage | O | string (u..2000) | Опциональное сообщение для печати на чеке. Язык: русский, кодировка: UTF-8. Может использоваться форматирование. |
operatorMessage | O | string (u..2000) | Опциональное сообщение для отображения кассиру. Язык: русский, кодировка: UTF-8. Может использоваться форматирование. |
pointsAllocation | O | массив PointsAllocation | Распределение оплаты баллами по товарам чека и максимальная скидка. |
cardholderInfo | O | массив CardholderInfoItem | Данные держателя карты. |
accStatementInfo | O | массив AccStatementItem | Выписка со счета карты или держателя карты. Содержит информацию о последних N операциях по счету карты или держателя карты на момент после выполнения текущего запроса. N - количество операций определяется настройками в ПЦ и не превышает 200. |
Структура BatchRequestItem
Вспомогательная структура предназначена для передачи запроса пакетной загрузки неавторизованных операций начисления баллов и возврата товаров.
Атрибут | Обяз. | Тип | Комментарии |
authData | C | AuthRequestData | Данные неавторизованной операции начисления баллов. |
refundData | C | RefundRequestData | Данные неавторизованной операции возврата товара. |
Присутствует один из элементов: либо authData, либо refundData.
Структура предназначена для передачи запроса пакетной загрузки неавторизованных операций начисления баллов.
Атрибут | Обяз. | Тип | Комментарии |
sequence | M | массив BatchRequestItem | Пакет данных неавторизованных операций начисления баллов или возврата товара. Количество записей в одном пакете ограничено. |
Структура предназначена для передачи запроса операции возврата.
Атрибут | Обяз. | Тип | Комментарии |
transaction | M | TransactionData | Ключевая информация об операции возврата. |
amount | M | long (n..18) | Общая стоимость возвращаемых товаров, в минимальных единицах валюты (например, копейках). |
currency | M | string (n3) | Валюта чека (операции). Числовой код по ISO 4217 (см.: http://www. iso. org/iso/en/prods-services/popstds/currencycodeslist. html) |
payment | C | массив PaymentItem | Информация о суммах возвращаемых покупателю денег (НЕ баллов) по различным средствам оплаты. Присутствует при возвратах offline (через batchLoad). Если данный массив присутствует, то сумма по всем PaymentItem. amount должна совпадать с общей суммой возврата (AuthRequestData. amount). |
origId | M | string (an..50) | Идентификатор оригинальной транзакции (операции покупки, по которой осуществляется возврат). N. B. Значение данного поля является регистро-независимым (ПЦ хранит значение в верхнем регистре) |
origTerminal | C | string (an..100) | Идентификатор кассы (POS) – источника оригинальной транзакции. Обязателен в случае прямого подключения POS’а. |
origLocation | C | string (an..50) | Код места установки POS’а – источника оригинальной транзакции. Обязателен в случае прямого подключения POS’а. |
origPartnerId | C | long (n..18) | Идентификатор Участника – источника оригинальной транзакции. Обязателен в случае прямого подключения POS’а. |
cheque | O | массив ChequeItem | Состав чека возврата (список возвращаемых товаров). Если данный массив присутствует, то сумма по всем ChequeItem. amount должна совпадать с общей суммой возврата (AuthRequestData. amount). |
Структура предназначена для передачи ответа на запрос операции возврата.
Атрибут | Обяз. | Тип | Комментарии |
authRes | M | AuthResponseData | Общие данные результата обработки авторизационного запроса. |
payment | O | массив PaymentItem | Информация о суммах возвращаемых покупателю денег (НЕ баллов) по различным средствам оплаты. Отcутствует, если в результате выполнения операции покупатель не получает деньги (возвращаются только баллы). |
Структура предназначена для передачи запроса операции.
Атрибут | Обяз. | Тип | Комментарии |
transaction | M | TransactionData | Ключевая информация об операции, среди которой - один из идентификаторов карты. Для операции привязки – идентификатор основной карты; Для операции замены карты – идентификатор новой карты. |
track1 | C | string (ans..76) | Данные первого трека магнитной полосы карты: для операции привязки – дополнительной карты; для операции замены карты – старой карты. Обязательно присутствует при идентификации карты по первому треку магнитной полосы. |
track2 | C | string (ans..37) | Данные второго трека магнитной полосы карты: для операции привязки – дополнительной карты; для операции замены карты – старой карты. Обязательно присутствует при идентификации карты по второму треку магнитной полосы. |
track3 | C | string (ans..104) | Данные третьего трека магнитной полосы карты: для операции привязки – дополнительной карты; для операции замены карты – старой карты. Обязательно присутствует при идентификации карты по третьему треку магнитной полосы. |
barCode | C | string (an..128) | Штрих-код карты, например EAN-13: для операции привязки – штрих-код дополнительной карты; для операции замены карты – штрих-код старой карты. Обязательно присутствует при идентификации карты по штрих-коду. |
pan | C | string (n..19) | Номер карты, напечатанный на карте: для операции привязки – номер дополнительной карты; для операции замены карты – номер старой карты. Обязательно присутствует при ручном вводе номера карты. |
hash | C | string (an..128) | Значение известной хэш-функции на номере карты (или треке): для операции привязки – дополнительной карты; для операции замены карты – старой карты. Поле формируется следующим образом: HASH (БИН):HASH(ПАН) |
gcdata | C | string (an..100) | Данные чиповой карты ЗК в формате SN:ISO, где SN – серийный номер чиповой карты, ISO – ISO чиповой карты ЗК. Для операции привязки – дополнительной карты; для операции замены карты – старой карты. При работе с gcdata заполнение серийного номера – обязательно. |
Структура InfoRequestData
Структура предназначена для передачи запроса расширенной информации по карте.
Атрибут | Обяз. | Тип | Комментарии |
transaction | M | TransactionData | Ключевая информация об операции, среди которой - один из идентификаторов карты. |
cheque | С | массив ChequeItem | Состав чека. Обязателен для получения максимальной скидки |
getCardholder | O | string (n1) | «Флаг» формирования информации о держателе карты в ответе на операцию. Принимает значения 0 (не формировать; по умолчанию) или 1 (формировать). |
getAccStatement | O | string (n1) | «Флаг» формирования выписки по счету карты или держателя карты в ответе на операцию. Принимает значения 0 (не формировать; по умолчанию) или 1 (формировать). |
accStatementParams | O | AccStatementParams | Параметры формирования выписки. Передается только вместе с атрибутом getAccStatement |
Структура CardholderRequestData
Структура предназначена для передачи запроса операции.
|
Из за большого объема этот материал размещен на нескольких страницах:
1 2 3 4 5 6 7 8 9 10 11 12 |
