Центр финансовых технологий (стр. 2 )

Общий принцип при откате транзакций – откат перепосылается до получения положительного ответа от ПЦ.

Как положительные трактуются следующие ответы:

OK (откат успешно принят и обработан); TRANSACTION_NOT_FOUND (оригинальная операция не была авторизована, откатывать нечего); TRANSACTION_ALREADY_REVERSED (транзакция уже откачена).

Все другие ответы от ПЦ, равно как и отсутствие ответа от ПЦ, должны приводить к перепосылке отката. Перепосылка отката должна производиться через увеличивающиеся интервалы времени.

Параметры

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

Возвращаемое значение

Структура ResponseStatus. Результат выполнения операции в ПЦ

Порядок обработки сообщений

Откат операции. Успех с первого раза

Откат операции. Перепосылка

Метод refund

Метод используется для реализации сценариев Возврат на операцию оплаты баллами (дополнительный сценарий), Возврат на операцию начисления баллов (дополнительный сценарий), Возврат товара, купленного по подарочной карте

Параметры

Структура RefundRequestData. Структура предназначена для передачи запроса операции возврата.

Возвращаемое значение

Структура RefundResponseData. Структура предназначена для передачи ответа на запрос операции возврата.

Порядок обработки сообщений

Возврат на операцию оплаты баллами

В запросе на возврат по операции оплаты баллами в структуре платежных инструментов необходимо указывать платежный инструмент ‘P’ и сумму, которую необходимо вернуть на бонусный счет клиента. Запрос на возврат по операции оплаты баллами может быть выполнен в режиме Online или режиме Offline. При выполнении этого запроса при отсутствии связи с ПЦ или получении ошибки 996 операция ставится в очередь для дальнейшей передачи в батче.

Возврат по операции оплаты баллами. Успех

Возврат по операции оплаты баллами. Нет ответа от ПЦ или ошибка 996

Возврат на операцию начисления баллов

В запросе на возврат по операции начисления баллов в сумме операции передается общая сумма, возвращаемая клиенту (вместе с суммой, возвращенной клиенту баллами). В структуре платежных инструментов сумма, возвращенная клиенту баллами, передается в платежном инструменте ‘N’. Запрос на возврат по операции начисления баллов может быть выполнен как в режиме Online, так и в режиме Offline. Вне зависимости от ответа от ПЦ операция ставится в очередь для дальнейшей передачи в батче.

Возврат на операцию начисления баллов. Успех

Возврат на операцию начисления баллов. Нет ответа от ПЦ или ошибка 996

Возврат по  операции  оплаты подарочной картой.

Запрос на возврат по операции оплаты подарочной картой выполняется в режиме Online. В случае отсутствия ответа от ПЦ или получения ошибки 996, должен быть сформирован и передан откат по операции возврата.

Возврат по операции оплаты подарочной картой. Успех

Возврат по операции оплаты подарочной картой. Нет ответа от ПЦ или ошибка 996

Метод linkCard

Метод используется для реализации сценария “Привязать карту”

Параметры

Структура LinkRequestData. Структура предназначена для передачи запроса операции привязки карты.

Возвращаемое значение

Структура AuthResponseData. Структура предназначена для передачи ответа на запрос операции.

Порядок обработки сообщений

Привязать карту. Успех

Привязать карту. Нет ответа от ПЦ или ошибка 996

Метод replaceCard

Метод используется для реализации сценария “Заменить карту”

Параметры

Структура LinkRequestData. Структура предназначена для передачи запроса операции замены карты.

Возвращаемое значение

Структура AuthResponseData. Структура предназначена для передачи ответа на запрос операции.

Порядок обработки сообщений

Заменить карту. Успех

Заменить карту. Нет ответа от ПЦ или ошибка 996

Метод activate

Метод используется для реализации сценария Активация подарочной карты (Продажа подарочной карты).

Параметры

Структура AuthRequestData. Структура предназначена для передачи запроса операции.

Возвращаемое значение

Структура AuthResponseData. Структура предназначена для передачи ответа на запрос операции.

Порядок обработки сообщений

Активация карты. Успех

Активация карты. Нет ответа от ПЦ или ошибка 996

Метод authGift

Метод используется для реализации сценария “Оплата подарочной картой”

Параметры

Структура AuthRequestData. Структура предназначена для передачи запроса операции.

Возвращаемое значение

Структура AuthResponseData. Структура предназначена для передачи ответа на запрос операции.

Порядок обработки сообщений

Оплата подарочной картой. Успех

Оплата подарочной картой. Нет ответа от ПЦ или ошибка 996

Метод getInfo2

Метод используется в реализации сценария совершение покупки с использованием бонусной карты (запрос максимальной суммы оплаты баллами/оплата баллами/начисление баллов), запрос расширенной информации по карте и/или о держателе карты.

Параметры

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

Возвращаемое значение

Структура AuthResponseData. Структура предназначена для передачи ответа на запрос операции.

Порядок обработки сообщений

Заметки

При неполучении ответа от ПЦ или при получении ошибки 996, касса НЕ посылает откат в ПЦ.

Метод getAuthToken

Метод используется в реализации сценария оплата баллами с авторизацией по токену (для Интернет-платежей).

Параметры

Структура AuthRequestData. Структура предназначена для передачи запроса операции.

Возвращаемое значение

Структура TokenResponseData. Структура предназначена для передачи ответа на запрос операции.

Порядок обработки сообщений

Заметки

При неполучении ответа от ПЦ или при получении ошибки 996, касса НЕ посылает откат в ПЦ. Порядок обработки неуспешного завершения авторизации оплаты баллами описан в разделе Метод authPoints.

Метод directPoints

Метод используется для сценария прямого изменения бонусного остатка на карте.

Для возможности использования данного метода необходима  специальная настройка на ПЦ. По умолчанию в ПЦ настройка отключена, в этом случае при попытке обращения к данному методу ПЦ вернёт ошибку ILLEGAL_OPERATION.

Параметры

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

Возвращаемое значение

Структура AuthResponseData. Структура предназначена для передачи ответа на запрос операции.

Порядок обработки сообщений

Изменение бонусного остатка на карте. Успех

Изменение бонусного остатка на карте. Нет ответа от ПЦ или ошибка 996

Метод setCardholder

Метод используется для реализации сценария обновить или загрузить данные держателя карты.

Параметры

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

Возвращаемое значение

Структура AuthResponseData. Структура предназначена для передачи ответа на запрос операции.

Порядок обработки сообщений

Заметки

При попытке обновить данные для несуществующего в ПЦ держателя карты ПЦ автоматически регистрирует нового держателя карты с данными из запроса, если были переданы идентификационные данные держателя карты.

При неполучении ответа от ПЦ или при получении ошибки 996, касса НЕ посылает откат в ПЦ.

Метод getInfoDeals

Метод используется для реализации сценариев: запрос списка купонов по карте, совершение покупки с использованием купона.

Параметры

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

Возвращаемое значение

Структура InfoDealsResponseData. Структура предназначена для передачи ответа на запрос операции.

Порядок обработки сообщений