<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:xsd="http://www. w3.org/2001/XMLSchema" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance">

<soapenv:Body>

<reverseResponse xmlns="">

<response>

<status>

        ...

</status>

</response>

</reverseResponse>

</soapenv:Body>

</soapenv:Envelope>

SOAPAction: "urn:#getInfo2"

<?xml version="1.0" encoding="utf-8"?>

<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:xsd="http://www. w3.org/2001/XMLSchema" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance">

<soapenv:Body>

<getInfo2Response xmlns="">

<response>

<status>

...

</status>

<pcId>...</pcId>

<cardInfo>

...

</cardInfo>

<cardInfo>

...

</cardInfo>

<chequeMessage>...</chequeMessage>

<operatorMessage>...</operatorMessage>

               <pointsAllocation>

  ...

  </pointsAllocation>

  <cardholderInfo>

  ...

  </cardholderInfo>

  <accStatementInfo>

  ...

  </accStatementInfo>

</response>

</getInfo2Response>

</soapenv:Body>

</soapenv:Envelope>

SOAPAction: "urn:#getAuthToken"

<?xml version="1.0" encoding="utf-8"?>

<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:xsd="http://www. w3.org/2001/XMLSchema" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance">

НЕ нашли? Не то? Что вы ищете?

<soapenv:Body>

<getAuthTokenResponse xmlns="">

<response>

<status>

...

</status>

               <validThrough>...</validThrough>

</response>

</getAuthTokenResponse>

</soapenv:Body>

</soapenv:Envelope>

SOAPAction: "urn:#directPoints"

<?xml version="1.0" encoding="utf-8"?>

<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:xsd="http://www. w3.org/2001/XMLSchema" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance">

<soapenv:Body>

<directPointsResponse xmlns="">

<response>

<status>

...

</status>

<pcId>...</pcId>

<cardInfo>

...

</cardInfo>

</response>

</directPointsResponse>

</soapenv:Body>

</soapenv:Envelope>

SOAPAction: "urn:#setCardholder"

<?xml version="1.0" encoding="utf-8"?>

<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:xsd="http://www. w3.org/2001/XMLSchema" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance">

<soapenv:Body>

<setCardholderResponse xmlns="">

<response>

<status>

        ...

</status>

  <cardholderInfo>

          ...

  </cardholderInfo>

  <accStatementInfo>

  ...

  </accStatementInfo>

</response>

</setCardholderResponse>

</soapenv:Body>

</soapenv:Envelope>

SOAPAction: "urn:#getInfoDeals"

<?xml version="1.0" encoding="utf-8"?>

<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:xsd="http://www. w3.org/2001/XMLSchema" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance">

<soapenv:Body>

<getInfoDealsResponse xmlns="">

<response>

<status>

...

</status>

<pcId>...</pcId>

<cardInfo>

...

</cardInfo>

<chequeMessage>...</chequeMessage>

<operatorMessage>...</operatorMessage>

<deals>

...

</deals>

<dealTypes>

...

</dealTypes>

</response>

</getInfoDealsResponse>

</soapenv:Body>

</soapenv:Envelope>

SOAPAction: "urn:#authDeals"

<?xml version="1.0" encoding="utf-8"?>

<soapenv:Envelope xmlns:soapenv="http://schemas. xmlsoap. org/soap/envelope/" xmlns:xsd="http://www. w3.org/2001/XMLSchema" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance">

<soapenv:Body>

<authDealsResponse xmlns="">

<response>

<status>

...

</status>

<pcId>...</pcId>

<cardInfo>

...

</cardInfo>

</response>

</authDealsResponse>

</soapenv:Body>

</soapenv:Envelope>


Использование расширений интерфейса

Интерфейс предоставляет несколько дополнительных возможностей, для использования которых используются данные, передаваемые в расширениях (поле extensions структуры TransactionData).

ПЦ умеет работать со следующими критическими типами расширений:

Тип

Комментарии

CHEQUE_MSG_REQ

Используется для формирования полноценного чека в ответ на операцию.

REALSELLER

Используется для авторизации по агентской схеме.

OTP

Используется в оплате баллами с авторизацией по токену

Названия типов расширений и их параметров не чувствительны к регистру букв.


Формирование полноценного чека в ответ на операцию

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

ПЦ может формировать полноценный отформатированный и готовый к печати чек. Для формирования такого чека в ответ на совершаемую операцию необходимы:

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

Для указания ПЦ формировать полноценный чек используется специальное расширение:

Атрибут

Примечание

type

“CHEQUE_MSG_REQ” constant

Critical

“Y” constant

Params

Параметры расширения описаны ниже

Данное расширение поддерживает следующие параметры:

Название

Обяз.

Отнош.

Комментарии

“MSG_REQ”

M

1

Признак формирования полноценного чека  (да = “y” или нет = “n”).

Авторизация по агентской схеме

Стандартно авторизация операции в ПЦ производится под тем участником, который инициировал данную операцию. Однако можно авторизоваться и по агентской схеме, когда операция инициируется агентом, но в ПЦ проводится под другим участником (реальным продавцом).

Для авторизации по агентской схеме необходимо:

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

Данные агента стандартно передаются в структуре AuthRequestData. Данные реального продавца передаются через расширение.

Атрибут

Примечание

type

“REALSELLER” constant

Critical

“Y” constant

Params

Параметры расширения описаны ниже

Данное расширение поддерживает следующие параметры:

Название

Обяз.

Отнош.

Комментарии

“KTOID”

M

1

Идентификатор Участника, под которым он зарегистрирован в ПЦ.

“LOCATION”

O

0..1

Код места установки POS’а (например, магазина).

Если данный параметр задан, то авторизация проводится от лица указанного POS’а.

Когда параметр отсутствует, то в зависимости от настроек на ПЦ:

    авторизация проводится от POS’а с кодом “PARNER_ID#LOCATION”, где PARTNER_ID и LOCATION – данные агента. Если POS с таким кодом на ПЦ не зарегистрирован, регистрация производится автоматически при совершении операции; либо авторизация проводится от имени партнёра без привязки к POS.

Авторизация через агентскую схему возможна при работе следующих методов интерфейса:

    authPoints; directPoints.

А также при отмене указанных операций методом reverse интерфейса. При отмене передаются данные агента из оригинальной операции. Данные реального продавца в составе структуры TransactionData. extensions передавать не требуется.


Дополнительные данные покупки

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

Дополнительные параметры передаются через расширение.

Атрибут

Примечание

type

“PURCHASE_EXT_PARAMS” constant

Critical

“Y” constant

Params

Зарезервированные параметры расширения описаны ниже

Названия параметров регистронезависимы, ПЦ хранит название в верхнем регистре. Данное расширение поддерживает следующие параметры.

Название

Обяз.

Отнош.

Комментарии

“Country”

O

0..1

Код страны мерчанта, принявшего оплату

“Paysys”

O

0..1

Код платежной системы

“Ext-merch-id”

O

0..1

Card acceptor id (DE42)

“Acqrr”

O

0..1

Идентификатор банка-эквайрера (DE94)

“CardPrdId”

O

0..1

Идентификатор карточного продукта

“Credit_programm”

O

0..1

Идентификатор кредитного продукта

Использование данного расширения согласуется с ЦФТ.

Из за большого объема этот материал размещен на нескольких страницах:
1 2 3 4 5 6 7 8 9 10 11 12