Электронные подарочные сертификаты

Редактировал(а) Татьяна Брыкова 2026/03/24 07:08

Общая информация

Выпуск подарочных сертификатов

Начисление денежных средств на подарочный сертификат/активация подарочного сертификата

Запрос баланса подарочного сертификата

Списание денежных средств с подарочного сертификата

Дарение выпущенного сертификата/смена владельца сертификата

Работа с подарочными сертификатами в Мanzana Loyalty Online (через UI)

API_Операции с подарочными сертификатами

Общая информация

Функционал электронных подарочных сертификатов реализован на базе стандартных карт
В качестве средств подарочного сертификата используется денежный счёт карты
Подарочные сертификаты не привязаны к контактам, как обычные карты. Они используются без контактов.
В качестве владельца подарочного сертификата в расширенном атрибуте (РА) карты указывается номер телефона и/или email. Владелец подарочного сертификата не обязательно является участником ПЛ и может не быть заведён как контакт в системе лояльности. Ключи РА карты в значении которых указываются телефон и email владельца подарочного сертификата записываются в партнёрских настройках:

Loyalty.Processing.MoneyRequest.ChargeOperation.Phone.CardEAKey	Ключ расширенного атрибута карты, в значение которого происходит сохранение номера телефона при обработке запроса начисления денег. Значение по умолчанию – Phone
Loyalty.Processing.MoneyRequest.ChargeOperation.Email.CardEAKey	Ключ расширенного атрибута карты, в значение которого происходит сохранение адреса электронной почты при обработке запроса начисления денег. Значение по умолчанию – Email

Выпуск подарочных сертификатов

Выпуск подарочных сертификатов осуществляется через стандартный функционал генерации карт в МО.
При генерации карт в задании на выпуск необходимо указать, что статус выпускаемых карт должен быть «Новая». Это регулируется настройкой в задании на выпуск карт: Активировать карты = Нет.

Начисление денежных средств на подарочный сертификат/активация подарочного сертификат

1. Начисление денежных средств на подарочный сертификат может производиться с верификацией и без верификации.

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

3. В запросе начисления денежных средств на подарочный сертификат можно указывать расширенные атрибуты (РА), которые в результате выполнения запроса будут созданы как РА карты (подарочного сертификата). В данных РА можно указывать любую необходимую информацию, которую можно будет использовать в дальнейшем.

Например:

Телефон дарителя подарочного сертификата
Номинал подарочного сертификата
Какие-либо даты

и т.д.

Для того, чтобы по РА запроса начисления были созданы РА карты, необходимо данные РА указать в настройках «Определения расширенных атрибутов».

4. В запросе начисления денежных средств на подарочный сертификат в обязательном порядке необходимо указывать телефон и/или email владельца подарочного сертификата. В результате выполнения запроса телефон и/или email будут записаны в соответствующие РА подарочного сертификата (карты.) Значения ключей РА для телефона и email указываются в партнёрских настройкам Loyalty.Processing.MoneyRequest.ChargeOperation.Phone.CardEAKey и Loyalty.Processing.MoneyRequest.ChargeOperation.Email.CardEAKey

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

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

   <SOAP-ENV:Header/>

   <SOAP-ENV:Body>

      <ProcessRequest xmlns="http://loyalty.manzanagroup.ru/loyalty.xsd">

         <request>

            <MoneyRequest>

               <RequestID>sryb</RequestID>

               <DateTime>2025-10-14T15:01:11.17</DateTime>

               <Timeout>360</Timeout>

               <Organization>Partner</Organization>

               <BusinessUnit>mp</BusinessUnit>

               <POS>mp</POS>

               <Card>

                  <CardNumber>br_gf_00352</CardNumber>

               </Card>

               <ExtendedAttribute>

                  

                  <Key>ContactExternalId</Key>

                  <Value>56cf3661-ab18-43ba-9841-866ab5399533</Value>

               </ExtendedAttribute>

               <ExtendedAttribute>

                  

                  <Key>PhoneBuyer</Key>

                  <Value>+79998889977</Value>

               </ExtendedAttribute>

               <ExtendedAttribute>

                  

                  <Key>Nominal</Key>

                  <Value>1000</Value>

               </ExtendedAttribute>

               <ExtendedAttribute>

                  

                  <Key>CertificateExternalId</Key>

                  <Value>56cf3661-ab18-43ba-9841-866ab5399533</Value>

               </ExtendedAttribute>

               <Number>test_01</Number>

               <OperationType>Sale</OperationType>

               <AwardType>Money</AwardType>

               <ChargeType>Charge</ChargeType>

               <Activate>1</Activate>

               <Value>1000</Value>

               

               <Phone>+79998765432</Phone>

               <Email>mail@mail.ru</Email>

               <SendCode>0</SendCode>

               <VerificationCode/>

            </MoneyRequest>

         </request>

         <orgName>LoyaltyTag2Test</orgName>

      </ProcessRequest>

   </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Ответ запроса начисления денежных средств:

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

   <soap:Body>

      <ProcessRequestResponse xmlns="http://loyalty.manzanagroup.ru/loyalty.xsd">

         <ProcessRequestResult>

            <MoneyResponse>

               <TransactionID>-9223372036843346393</TransactionID>

               <RequestID>sryb</RequestID>

               <Processed>2025-10-01T16:50:09.883</Processed>

               <ReturnCode>0</ReturnCode>

               <Message>Начислено денег: 1000,00</Message>

               <ExtendedAttribute>

                  <Key>PhoneBuyer</Key>

                  <Value>+79998889977</Value>

               </ExtendedAttribute>

               <ExtendedAttribute>

                  <Key>Nominal</Key>

                  <Value>1000</Value>

               </ExtendedAttribute>

               <ExtendedAttribute>

                  <Key>ContactExternalId</Key>

                  <Value>56cf3661-ab18-43ba-9841-866ab5399533</Value>

               </ExtendedAttribute>

               <ExtendedAttribute>

                  <Key>CertificateExternalId</Key>

                  <Value>56cf3661-ab18-43ba-9841-866ab5399533</Value>

               </ExtendedAttribute>

            </MoneyResponse>

         </ProcessRequestResult>

      </ProcessRequestResponse>

   </soap:Body>

</soap:Envelope>

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

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

   <SOAP-ENV:Header/>

   <SOAP-ENV:Body>

      <ProcessRequest xmlns="http://loyalty.manzanagroup.ru/loyalty.xsd">

         <request>

            <MoneyRequest>

               <RequestID>sryb</RequestID>

               <DateTime>2025-10-01T15:01:11.17</DateTime>

               <Timeout>360</Timeout>

               <Organization>partner</Organization>

               <BusinessUnit>mp</BusinessUnit>

               <POS>mp</POS>

               <Card>

                  <IDEmissionTask>Выпуск карт_gift</IDEmissionTask>

               </Card>

               <ExtendedAttribute>

                  

                  <Key>ContactExternalId</Key>

                  <Value>56cf3661-ab18-43ba-9841-866ab5399533</Value>

               </ExtendedAttribute>

               <ExtendedAttribute>

                  

                  <Key>PhoneBuyer</Key>

                  <Value>+79998889977</Value>

               </ExtendedAttribute>

               <ExtendedAttribute>

                  

                  <Key>Nominal</Key>

                  <Value>1000</Value>

               </ExtendedAttribute>

               <ExtendedAttribute>

                  

                  <Key>CertificateExternalId</Key>

                  <Value>56cf3661-ab18-43ba-9841-866ab5399533</Value>

               </ExtendedAttribute>

               <Number>test_02</Number>

               <OperationType>Sale</OperationType>

               <AwardType>Money</AwardType>

               <ChargeType>Charge</ChargeType>

               <Activate>1</Activate>

               <Value>1000</Value>

               

               <Phone>+79998765432</Phone>

               <Email>mail@mail.ru</Email>

               <SendCode>0</SendCode>

               <VerificationCode/>

            </MoneyRequest>

         </request>

         <orgName>LoyaltyTag2Test</orgName>

      </ProcessRequest>

   </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Ответ:

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

   <soap:Body>

      <ProcessRequestResponse xmlns="http://loyalty.manzanagroup.ru/loyalty.xsd">

         <ProcessRequestResult>

            <MoneyResponse>

               <TransactionID>-9223372036843346169</TransactionID>

               <RequestID>sryb</RequestID>

               <Processed>2025-10-01T17:12:16.557</Processed>

               <ReturnCode>0</ReturnCode>

               <Message>Начислено денег: 1000,00</Message>

               <ExtendedAttribute>

                  <Key>PhoneBuyer</Key>

                  <Value>+79998889977</Value>

               </ExtendedAttribute>

               <ExtendedAttribute>

                  <Key>Nominal</Key>

                  <Value>1000</Value>

               </ExtendedAttribute>

               <ExtendedAttribute>

                  <Key>ContactExternalId</Key>

                  <Value>56cf3661-ab18-43ba-9841-866ab5399533</Value>

               </ExtendedAttribute>

               <ExtendedAttribute>

                  <Key>CertificateExternalId</Key>

                  <Value>56cf3661-ab18-43ba-9841-866ab5399533</Value>

               </ExtendedAttribute>

               <Card>

                  <CardNumber>br_gf_00354</CardNumber>

                  <CodeWord>4130124227</CodeWord>

               </Card>

            </MoneyResponse>

         </ProcessRequestResult>

      </ProcessRequestResponse>

   </soap:Body>

</soap:Envelope>

5. При успешной обработке запроса начисления денег на подарочный сертификат у сертификата (карты) меняется статус на «Активный» и производится начисление указанной в запросе суммы на денежный счёт.

6. По результату выполнения запроса и начислении денежных средств на подарочный сертификат можно настроить отправку сообщения с информацией о начислении. Отправка сообщения осуществляется на номер телефона и/или email владельца подарочного сертификата. Включение отправки сообщения и применяемый для сообщения шаблон указываются в соответствующих партнёрских настройках (см. следующий пункт).

При формировании шаблона сообщения SMS и Email с информацией о начислении используется метапеременная %charged_money% - сумма начисленных денежных средств по текущей операции (если со знаком минус – это списание).

Пример информационного сообщения:

Добрый день!

Вам выдан сертификат br_gf_00354 номиналом 1000 руб.

Кодовое слово карты 4130124227

7. Партнёрские настройки, используемые при начислении денежных средств на подарочный сертификат

Loyalty.Processing.MoneyRequest.ChargeOperation. VerificationCode.Check	Настройка, определяющая необходимость верификации запроса начисления денег через проверочный код, отправляемый по SMS и/или Email. Значение 1, y или Y означает включенный функционал. Если значение отлично от 1, y или Y, в том числе пусто delete, то действует прежний алгоритм начисления денег без верификации проверочным кодом. Значение по умолчанию – 0.
Loyalty.Processing.MoneyRequest.ChargeOperation. Verification.Channel	Настройка, определяющая канал отправки проверочного кода при обработке запроса начисления денег. Значения: 1 - только SMS; 2 - только Email; 3 - SMS и Email. Значение по умолчанию – 3.
Loyalty.Processing.MoneyRequest.ChargeOperation. Verification.SMSTemplate	Внешний идентификатор шаблона SMS сообщения для отправки проверочного кода через SMS при обработке запроса начисления денег. Проверочный код задаётся в тексте сообщения с помощью метапеременной %verification_code%
Loyalty.Processing.MoneyRequest.ChargeOperation. Verification.EmailTemplate	Внешний идентификатор шаблона Email сообщения для отправки проверочного кода через Email при обработке запроса начисления денег. Проверочный код задаётся в тексте сообщения с помощью метапеременной %verification_code%
Loyalty.Processing.MoneyRequest.ChargeOperation. Verification.CodeLength	Длина проверочного кода, отправляемого при обработке запроса начисления денег. Значение по умолчанию – 5.
Loyalty.Processing.MoneyRequest.ChargeOperation. Verification.CodeLifeTime	Срок действия (в минутах) проверочного кода для верификации запроса начисления денег. Значение по умолчанию - 5.
Loyalty.Processing.MoneyRequest.ChargeOperation. Verification.CodeType	Тип проверочного кода, отправляемого при обработке запроса начисления денег. 1 - только цифры, 2 - цифры и буквы латинского алфавита. Значение по умолчанию – 1.
Loyalty.Processing.MoneyRequest.ChargeOperation. Phone.SaveCardEA	Настройка для необходимости сохранения номера телефона в расширенный атрибут карты при обработке запроса начисления денег. Значение 1, y или Y означает включенный функционал. Если значение отлично от 1, y или Y, в том числе пусто delete, то сохранение номера телефона в РА карты не происходит. Значение по умолчанию – 0.
Loyalty.Processing.MoneyRequest.ChargeOperation. Phone.CardEAKey	Ключ расширенного атрибута карты, в значение которого происходит сохранение номера телефона при обработке запроса начисления денег. Значение по умолчанию – Phone
Loyalty.Processing.MoneyRequest.ChargeOperation. Email.SaveCardEA	Настройка для необходимости сохранения адреса электронной почты в расширенный атрибут карты при обработке запроса начисления денег. Значение 1, y или Y означает включенный функционал. Если значение отлично от 1, y или Y, в том числе пусто delete, то сохранение адреса электронной почты в РА карты не происходит. Значение по умолчанию – 0.
Loyalty.Processing.MoneyRequest.ChargeOperation. Email.CardEAKey	Ключ расширенного атрибута карты, в значение которого происходит сохранение адреса электронной почты при обработке запроса начисления денег. Значение по умолчанию – Email
Loyalty.Processing.MoneyRequest. Verification.DayLimitSMS	Максимальное количество SMS, которое может быть отправлено при обработке запроса MoneyRequest в течение одного календарного дня. Значение по умолчанию - 10.
Loyalty.Processing.MoneyRequest. Verification.DayLimitEmail	Максимальное количество Email, которое может быть отправлено при обработке запроса MoneyRequest в течение одного календарного дня. Значение по умолчанию - 10.
Loyalty.Processing.MoneyRequest. Verification.LimitofvalidcodesByPhone	Количество попыток ввода проверочного кода при обработке запроса MoneyRequest в рамках одного телефона. Если значение не указано или указано не число, то ограничения на количество попыток ввода проверочного кода нет. Значение по умолчанию – 3.
Loyalty.Processing.MoneyRequest.Verification. LimitofvalidcodesByEmail	Количество попыток ввода проверочного кода при обработке запроса MoneyRequest в рамках одного Email. Если значение не указано или указано не число, то ограничения на количество попыток ввода проверочного кода нет. Значение по умолчанию – 3.
Loyalty.Processing.MoneyRequest.ChargeOperation. CardWithoutContact.Check	Настройка, определяющая необходимость проверки отсутствия контакта у карты при обработке запроса начисления денег. Значение 1, y или Y означает включенный функционал. Если значение отлично от 1, y или Y, в том числе пусто, то проверка на отсутствие контакта у карты не происходит. Значение по умолчанию – 0.
Loyalty.Processing.MoneyRequest. MobileNumberPattern.Check	Настройка, определяющая необходимость проверки номера телефона на допустимый формат при обработке запроса начисления денег. Значение 1, y или Y означает включенный функционал. Если значение отлично от 1, y или Y, в том числе пусто, то проверка на формат не происходит. Значение по умолчанию – 1.
Loyalty.Processing.MoneyRequest.ChargeOperation. SendInformationSMS.TurnOn	Настройка, определяющая необходимость отправки информационного SMS после обработки запроса начисления денег. Значение 1, y или Y означает включенный функционал. Если значение отлично от 1, y или Y, в том числе пусто, то отправки информационного SMS не происходит. Значение по умолчанию – 0.
Loyalty.Processing.MoneyRequest.ChargeOperation. SendInformationEmail.TurnOn	Настройка, определяющая необходимость отправки информационного Email после обработки запроса начисления денег. Значение 1, y или Y означает включенный функционал. Если значение отлично от 1, y или Y, в том числе пусто, то отправки информационного Email не происходит. Значение по умолчанию – 0.
Loyalty.Processing.MoneyRequest.ChargeOperation. SendInformationSMS.SMSTemplate	Внешний идентификатор шаблона SMS сообщения для отправки информационного SMS после обработки запроса начисления денег.
Loyalty.Processing.MoneyRequest.ChargeOperation. SendInformationEmail.EmailTemplate	Внешний идентификатор шаблона Email сообщения для отправки информационного Email после обработки запроса начисления денег.

Запрос баланса подарочного сертификата

1. Запрос баланса подарочного сертификата может производиться с верификацией и без верификации. Необходимость верификации устанавливается партнёрской настройкой Loyalty.Processing.MoneyRequest.BalanceOperation.VerificationCode.Check.

1.1. Запрос баланса подарочного сертификата без верификации

Запрос:

Ответ:

1.2. Запрос баланса подарочного сертификата с верификацией

1.2.1. Запрос кода верификации. В запросе необходимо указать кодовое слово карты (подарочного сертификата) в теге <CodeWord>4068036526</CodeWord>

Запрос:

Ответ:

Пример информационного сообщения с кодом верификации:

Код проверки для получения баланса подарочного сертификата br_gf_00005: 6856

1.2.2. Проверка кода и запрос баланса

Запрос:

Ответ:

1.2.3. По результату выполнения запроса можно настроить отправку сообщения с информацией о балансе подарочного сертификата. Отправка сообщения осуществляется на номер телефона и/или email владельца подарочного сертификата. Включение отправки сообщения и применяемый для сообщения шаблон указываются в соответствующих партнёрских настройках.

Пример информационного сообщения:

Добрый день!

Баланс сертификата номер br_gf_00354 составляет 1000 рублей

2. Партнёрские настройки, используемые при запросе баланса подарочного сертификата

Loyalty.Processing.MoneyRequest.BalanceOperation. VerificationCode.Check	Настройка, определяющая необходимость верификации запроса баланса денежного сертификата через проверочный код, отправляемый по SMS и/или Email. Значение 1, y или Y означает включенный функционал. Значение по умолчанию – 0
Loyalty.Processing.MoneyRequest.BalanceOperation. Verification.Channel	Настройка, определяющая канал отправки проверочного кода при обработке запроса баланса денежного сертификата. Значения: 1 - только SMS; 2 - только Email; 3 - SMS и Email. Значение по умолчанию – 3.
Loyalty.Processing.MoneyRequest.BalanceOperation. Verification.SMSTemplate	Внешний идентификатор шаблона SMS сообщения для отправки проверочного кода через SMS при обработке запроса баланса денежного сертификата.
Loyalty.Processing.MoneyRequest.BalanceOperation. Verification.EmailTemplate	Внешний идентификатор шаблона Email сообщения для отправки проверочного кода через Email при обработке запроса баланса денежного сертификата.
Loyalty.Processing.MoneyRequest.BalanceOperation. Verification.CodeLength	Длина проверочного кода, отправляемого при обработке запроса баланса денежного сертификата. Значение по умолчанию – 5.
Loyalty.Processing.MoneyRequest.BalanceOperation. Verification.CodeLifeTime	Срок действия (в минутах) проверочного кода для верификации запроса баланса денежного сертификата. Значение по умолчанию - 5.
Loyalty.Processing.MoneyRequest.BalanceOperation. Verification.CodeType	Тип проверочного кода, отправляемого при обработке запроса баланса денежного сертификата. 1 - только цифры, 2 - цифры и буквы латинского алфавита. Значение по умолчанию – 1.
Loyalty.Processing.MoneyRequest.BalanceOperation. SendInformationSMS.TurnOn	Настройка, определяющая необходимость отправки информационного SMS после обработки запроса баланса денежного сертификата. Значение 1, y или Y означает включенный функционал. Если значение отлично от 1, y или Y, в том числе пусто, то отправки информационного SMS не происходит. Значение по умолчанию – 0.
Loyalty.Processing.MoneyRequest.BalanceOperation. SendInformationEmail.TurnOn	Настройка, определяющая необходимость отправки информационного Email после обработки запроса баланса денежного сертификата. Значение 1, y или Y означает включенный функционал. Если значение отлично от 1, y или Y, в том числе пусто, то отправки информационного Email не происходит. Значение по умолчанию – 0.
Loyalty.Processing.MoneyRequest.BalanceOperation. SendInformationSMS.SMSTemplate	Внешний идентификатор шаблона SMS сообщения для отправки информационного SMS после обработки запроса баланса денежного сертификата.
Loyalty.Processing.MoneyRequest.BalanceOperation. SendInformationEmail.EmailTemplate	Внешний идентификатор шаблона Email сообщения для отправки информационного Email после обработки запроса баланса денежного сертификата.

Списание денежных средств с подарочного сертификата

1. Списание денежных средств с подарочного сертификата можно производить с верификацией или без верификации/

2. Списание денежных средств с подарочного сертификата можно производить без верификации

Запрос:

Ответ:

3. Списание денежных средств с подарочного сертификата с верификацией. Верификация списания может быть трёх типов:

По одноразовому коду из сообщения (СМС).
По кодовому слову подарочного сертификата (карты).
По 4-м последним цифрам номера телефона владельца подарочного сертификата.

4. Настройка типа верификации производится в Типе карты в секции "Параметры списания".

5. Списание денежных средств с подарочного сертификата с верификацией из кода сообщения (СМС)

5.1. Запрос на генерацию кода

Запрос:

Ответ:

5.2. Запрос на списание денежных средств

Запрос:

Ответ:

Важно! В запросе генерации кода верификации и в запросе списания с подтверждением кода верификации номера запросов должны совпадать.

6. Списание денежных средств с подарочного сертификата с верификацией кодовым словом карты происходит аналогичным запросом (п.5.2), при этом запрос на генерацию проверочного кода не используется, а в значение тега <VerificationCode>941</VerificationCode> указывается кодовое слово карты

7. Списание денежных средств с подарочного сертификата с верификацией 4-мя цифрами номера телефона владельца сертификата так же происходит аналогично запросу (п.5.2). Запрос на генерацию проверочного кода не используется, а в значении тега <VerificationCode>9411</VerificationCode> указываются 4 последние цифры телефона владельца подарочной карты.

8. Партнёрские настройки, используемые при списании средств с подарочного сертификата

Loyalty.Processing.MoneyRequest.WriteOffOperation. VerificationCode.Check	Настройка, определяющая необходимость верификации запроса списания денег через проверочный код, отправляемый по SMS и/или Email. Значение 1, y или Y означает включенный функционал. Если значение отлично от 1, y или Y, в том числе пусто, то действует прежний алгоритм списания денег без верификации проверочным кодом. Значение по умолчанию – 0.
Loyalty.Processing.MoneyRequest.WriteOffOperation. Verification.Channel	Настройка, определяющая канал отправки проверочного кода при обработке запроса списания денег. Значения: 1 - только SMS; 2 - только Email; 3 - SMS и Email. Значение по умолчанию – 3.
Loyalty.Processing.MoneyRequest.WriteOffOperation. Verification.SMSTemplate	Внешний идентификатор шаблона SMS сообщения для отправки проверочного кода через SMS при обработке запроса списания денег.
Loyalty.Processing.MoneyRequest.WriteOffOperation. Verification.EmailTemplate	Внешний идентификатор шаблона Email сообщения для отправки проверочного кода через Email при обработке запроса списания денег.
Loyalty.Processing.MoneyRequest.WriteOffOperation. Verification.CodeLength	Длина проверочного кода, отправляемого при обработке запроса списания денег. Значение по умолчанию – 5.
Loyalty.Processing.MoneyRequest.WriteOffOperation. Verification.CodeLifeTime	Срок действия (в минутах) проверочного кода для верификации запроса списания денег. Значение по умолчанию - 5.
Loyalty.Processing.MoneyRequest.WriteOffOperation. Verification.CodeType	Тип проверочного кода, отправляемого при обработке запроса списания денег. 1 - только цифры, 2 - цифры и буквы латинского алфавита. Значение по умолчанию – 1.
Loyalty.Processing.MoneyRequest.Verification. LimitofvalidcodesByCard	Количество попыток ввода проверочного кода при обработке запроса MoneyRequest в рамках одной карты. Если значение не указано или указано не число, то ограничения на количество попыток ввода проверочного кода нет. Значение по умолчанию – 3.
Loyalty.Processing.MoneyRequest.Verification. LimitofvalidCodeWordByCard	Количество попыток ввода кодового слова карты при обработке запроса MoneyRequest в течение одного календарного дня. Если значение не указано или указано не число, то ограничения на количество попыток ввода проверочного кода нет. Значение по умолчанию – 3.

Дарение выпущенного сертификата/смена владельца сертификата

Дарение подарочного сертификата может производиться с верификацией или без верификации. Дарение сертификата заключается в смене номера телефона и/или email владельца сертификата.

1. Запрос дарения подарочного сертификата без верификации. Новый номер телефона владельца подарочного сертификата указывается в теге <Phone>+79998765430</Phone>. Аналогично, если меняется email владельца сертификата, то новый email указывается в теге <Email>mail@mail.com</Email>

Запрос:

Ответ:

2. Запрос дарения подарочного сертификата с верификацией

Дарение подарочного сертификата с верификацией может проходить в два или три этапа.

1. Запрос кода верификации

2. Запрос дарения подарочного сертификата

Важно! В запросе генерации кода верификации и в запросе дарения с подтверждением кода верификации номера запросов должны совпадать.

Или

Запрос кода верификации
Запрос проверки кода верификации
Запрос дарения подарочного сертификата

Важно! В запросе генерации кода верификации и в запросе проверки кода верификации номера запросов должны совпадать.

2.1. Запрос кода верификации. Код верификации будет отправлен сообщением текущему владельцу подарочного сертификата.

Запрос:

Ответ:

2.2. Запрос проверки кода верификации.

Запрос:

Ответ:

2.3. Запрос дарения подарочного сертификата.

Запрос:

Ответ:

3. Для операции дарения поддерживаются SMS уведомления. Функциональность доступна при включении партнерских настроек:

4. Партнёрские настройки, используемые при дарении подарочного сертификата

Loyalty.Processing.MoneyRequest.GivingOperation. VerificationCode.Check	Настройка, определяющая необходимость верификации запроса дарения денежного сертификата через проверочный код, отправляемый по SMS и/или Email. Значение 1, y или Y означает включенный функционал. Значение по умолчанию – 0.
Loyalty.Processing.MoneyRequest.GivingOperation. Verification.Channel	Настройка, определяющая канал отправки проверочного кода при обработке запроса дарения денежного сертификата. Значения: 1 - только SMS; 2 - только Email; 3 - SMS и Email. Значение по умолчанию – 3.
Loyalty.Processing.MoneyRequest.GivingOperation. Verification.SMSTemplate	Внешний идентификатор шаблона SMS сообщения для отправки проверочного кода через SMS при обработке запроса дарения денежного сертификата.
Loyalty.Processing.MoneyRequest.GivingOperation. Verification.EmailTemplate	Внешний идентификатор шаблона Email сообщения для отправки проверочного кода через Email при обработке запроса дарения денежного сертификата.
Loyalty.Processing.MoneyRequest.GivingOperation. Verification.CodeLength	Длина проверочного кода, отправляемого при обработке запроса дарения денежного сертификата. Значение по умолчанию – 5.
Loyalty.Processing.MoneyRequest.GivingOperation. Verification.CodeLifeTime	Срок действия (в минутах) проверочного кода для верификации запроса дарения денежного сертификата. Значение по умолчанию - 5.
Loyalty.Processing.MoneyRequest.GivingOperation. Verification.CodeType	Тип проверочного кода, отправляемого при обработке запроса дарения денежного сертификата. 1 - только цифры, 2 - цифры и буквы латинского алфавита. Значение по умолчанию – 1.
Loyalty.Processing.MoneyRequest.GivingOperation.SendInformationSMS.TurnOn	Настройка, определяющая необходимость отправки информационного SMS после обработки запроса дарения подарочного сертификата. Значение 1, y или Y означает включенный функционал. Если значение отлично от 1, y или Y, в том числе пусто, то отправки информационного SMS не происходит. Значение по умолчанию – 0.
Loyalty.Processing.MoneyRequest.GivingOperation SendInformationSMS.SMSTemplate	Внешний идентификатор шаблона SMS сообщения для отправки информационного SMS после обработки запроса дарения подарочного сертификата. Значение по умолчанию NULL (Пусто).

Работа с подарочными сертификатами в Мanzana Loyalty Online (через UI)

1. Поиск подарочного сертификата

Поиск подарочного сертификата осуществляется через стандартное представление Карты в Мanzana Loyalty Online.

Но так как подарочный сертификат не привязан к контакту, стандартный поиск возможен только через номер сертификата. Карту также можно искать по РА подарочного сертификата (карты), в которых указываются дополнительные идентификаторы (телефон/email владельца подарочного сертификата, телефон дарителя, дополнительные идентификаторы и т.д.). Формирование РА подарочного сертификата происходит при начислении денег и активации подарочного сертификата (см. п. 3 в разделе Начисление денежных средств на подарочный сертификат/активация подарочного сертификат). Такой поиск по дополнительным полям (РА) производится через фильтры в представлении Карты.

Предварительно через партнёрскую настройку Loyalty.Interface.CardEAs.As.CardFields необходимо указать какие РА выводить в фильтрации в представлении карт.

Например, при значении партнёрской настройки «Phone"Телефон Карты"Txt;Email"Email Карты"Txt;PhoneBuyer"Телефон дарителя"Txt;Partner_NUM"Номинал карты"Number» в фильтре по картам будут выводиться поля из РА карты:

Телефон получателя карты – поиск по текстовым значениям РА «Phone»
Email получателя карты – поиск по текстовым значениям РА «Email»
Телефон дарителя – поиск по текстовым значениям РА «PhoneBuyer»
Номинал карты – поиск по числовым значениям РА «Partner_NUM»

и т.д.

Примечание: вывод в фильтр по картам доступен только для текстовых значений РА.

Также указанные поля выводятся в представлении Карты.

2. Отправка повторного сообщения с информацией по сертификату

2.1. При необходимости через UI Manzana Loyalty можно отправить СМС с информацией по подарочному сертификату на телефон владельца подарочного сертификата. Может потребоваться, если владелец удалил изначальное сообщение, отправленное при выдаче сертификата, при дарении сертификата другому владельцу.

2.2. Предварительно в системе должен быть заведен шаблон сообщения с настроенными обязательными параметрами. Для информирования получателя о данных карты, в шаблоне необходимо указать:

«Тип сообщения» = «SMS»
«Использовать для отправки сообщений через форму» = «Показать на форме карты». При таком значении на форме карты в окне отправке смс будет доступен для выбора этот шаблон. Если параметр «Использовать для отправки сообщений через форму» = «Не показывать», такой шаблон сообщений не будет показываться при отправке смс из формы карты.
«Тип операции» = «Личный кабинет»
Метапеременные в тексте сообщения:

%card_num% - номер карты клиента
%card_codeword% - кодовое слово карты
%card_money_balance% - баланс денежных средств по карте операции. Значение выводится после совершения операции.

2.3. При указанной настройке при нажатии на кнопку «Отправить SMS» в представлении карты выводится меню с выбором шаблона СМС для отправки сообщения. В меню выводятся шаблоны сообщений, у которых указан признак вывода на форме карты.

2.4. После выбора шаблона и нажатии «Отправить» выводится дополнительное предупреждение

2.5. После подтверждения выводится результат отправки сообщения

2.6. Пример сформированного сообщения

Информация по подарочному сертификату br_gf_00355

Кодовое слово карты 3900257338

Баланс денежных средств на карте 998.00

3. Настройка ролей

Для того, чтобы можно было отправлять смс по подарочной карте из формы карты, необходимо в ролевой модели на вкладке LOYALTY в подразделе «Другие привилегии» добавить привилегию «Отправлять смс по выбранному шаблону».