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

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

АПК Ассист предоставляет для предприятий возможность организации рекламных акций трех типов:

Промоакции

При промоакции предприятие предоставляет скидку на своей стороне в случае оплаты покупателем товара (услуги) картой определенного банка и/или определенного типа.

При выполнении платежа по промоакции:

Предприятие передает в запросе на оплату сумму платежа уже с учетом скидки.

АПК Ассист проверяет карту покупателя на участие в промоакции:

  • если промоакция действует на момент платежа и карта подходит по условиям промоакции, то АПК Ассист выполняет платеж на сумму (со скидкой), переданную предприятием;
  • если промоакция не действует на момент платежа или карта не подходит по условиям промоакции, то платеж не осуществляется и выдается сообщение об ошибке.

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

Также для оплаты заказа по промоакции нужно передать в запросе дополнительный параметр «PROMONAME». Значением параметра является наименование конкретной промоакции. Уникальное наименование промоакции генерируется службой технической поддержки АПК Ассист и передается предприятию (также наименование может быть выбрано совместно с предприятием).

Основная часть настроек промоакций выполняется на стороне АПК Ассист. Для этого предприятию следует сообщить сотрудникам отдела технической поддержки АПК Ассист точные параметры промоакции:

  • время действия;
  • типы карт, которые участвуют в рекламной кампании.

Скидки

Скидка может предоставляться в рамках рекламной акции в случае оплаты покупателем товара (услуги) картой определенного банка и/или определенного типа.

Сумма заказа для оплаты со скидкой вычисляется на стороне АПК Ассист по утвержденным правилам акции.

Скидка может быть без передачи параметра «PROMONAME» или с передачей параметра «PROMONAME». Значением параметра является наименование конкретной акции со скидкой. Уникальное наименование акции со скидкой генерируется службой технической поддержки АПК Ассист и передается предприятию (также наименование может быть выбрано совместно с предприятием).

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

Для разных условий могут быть разные скидки без передачи параметра «PROMONAME». Если карта покупателя подходит для условий сразу нескольких скидок, то применяется скидка по утвержденным правилам акции.

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

Основная часть настроек скидок выполняется на стороне АПК Ассист. Для этого предприятию следует сообщить сотрудникам отдела технической поддержки АПК Ассист точные параметры скидки:

  • тип скидки с передачей или без передачи параметра «PROMONAME»;
  • время действия скидки;
  • текст сообщения для покупателя;
  • размер скидки в процентах и правила округления при вычислении суммы скидки, а также максимально возможная сумма скидки;
  • правила выбора скидки, если имеется несколько разных акций со скидками (суммирование скидок или использование максимальной из нескольких);
  • типы карт, которые участвуют в акции.

Следует иметь в виду, что оплата со скидкой в АПК Ассист будет состоять из двух операций: одной реальной на сумму заказа за вычетом скидки и второй виртуальной на сумму скидки. Обе операции будут отображаться в ЛК предприятия, а также в ответах веб-сервисов результатов платежей. В чеке для покупателя будет указана общая сумма заказа, оплаченная сумма и скидка.

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

В формате XML:

<?xml version='1.0' encoding='utf-8' standalone='yes'?>
<!DOCTYPE result [
<!ATTLIST result
                        firstcode CDATA #REQUIRED
                        secondcode CDATA #REQUIRED
                        count CDATA #REQUIRED>
<!ELEMENT result (order*)>
<!ELEMENT order (ordernumber?,billnumber?,testmode?,ordercomment?,orderamount?,ordercurrency?,firstname?,lastname?,middlename?,email?,orderdate?,orderstate?,packetdate?,signature?,checkvalue?,operation*)>
<!ELEMENT ordernumber (#PCDATA)>
<!ELEMENT billnumber (#PCDATA)>
<!ELEMENT testmode (#PCDATA)>
<!ELEMENT ordercomment (#PCDATA)>
<!ELEMENT orderamount (#PCDATA)>
<!ELEMENT ordercurrency (#PCDATA)>
<!ELEMENT firstname (#PCDATA)>
<!ELEMENT lastname (#PCDATA)>
<!ELEMENT middlename (#PCDATA)>
<!ELEMENT email (#PCDATA)>
<!ELEMENT orderdate (#PCDATA)>
<!ELEMENT orderstate (#PCDATA)>
<!ELEMENT packetdate (#PCDATA)>
<!ELEMENT signature (#PCDATA)>
<!ELEMENT checkvalue (#PCDATA)>
<!ELEMENT operation 
(billnumber?,operationtype?,operationstate?,amount?,currency?,clientip?,ipaddress?,meantype_id?,meantypename?,meansubtype?,meannumber?,cardholder?,issuebank?,bankcountry?,responsecode?,message?,customermessage?,recommendation?,approvalcode?,protocoltypename?,processingname?,operationdate?,authresult?,authrequired?,rrn?,extrrn?)>
<!ELEMENT operationtype (#PCDATA)>
<!ELEMENT operationstate (#PCDATA)>
<!ELEMENT amount (#PCDATA)>
<!ELEMENT currency (#PCDATA)>
<!ELEMENT clientip (#PCDATA)>
<!ELEMENT ipaddress (#PCDATA)>
<!ELEMENT meantype_id (#PCDATA)>
<!ELEMENT meantypename (#PCDATA)>
<!ELEMENT meansubtype (#PCDATA)>
<!ELEMENT meannumber (#PCDATA)>
<!ELEMENT cardholder (#PCDATA)>
<!ELEMENT issuebank (#PCDATA)>
<!ELEMENT bankcountry (#PCDATA)>
<!ELEMENT responsecode (#PCDATA)>
<!ELEMENT message (#PCDATA)>
<!ELEMENT customermessage (#PCDATA)>
<!ELEMENT recommendation (#PCDATA)>
<!ELEMENT approvalcode (#PCDATA)>
<!ELEMENT protocoltypename (#PCDATA)>
<!ELEMENT processingname (#PCDATA)>
<!ELEMENT operationdate (#PCDATA)>
<!ELEMENT authresult (#PCDATA)>
<!ELEMENT authrequired (#PCDATA)>
<!ELEMENT rrn (#PCDATA)>
<!ELEMENT extrrn (#PCDATA)>]>
<result firstcode='0' secondcode='0' count='1'>
        <order>
               <ordernumber>2022.07.11-6</ordernumber>
               <billnumber>5732614256223423</billnumber>
               <testmode>0</testmode>
               <ordercomment></ordercomment>
               <orderamount>100.00</orderamount>
               <ordercurrency>RUB</ordercurrency>
               <firstname>Test</firstname>
               <lastname>Testov</lastname>
               <middlename>T.</middlename>
               <email>test@assist.ru</email>
               <orderdate>11.07.2022 07:23:02</orderdate>
               <orderstate>Approved</orderstate>
               <packetdate>11.07.2022 07:41</packetdate>
               <signature></signature>
               <checkvalue>65A46731208432C4018D42091E8E4F35</checkvalue>
               <operation>
                   <billnumber>5732614256223423.1</billnumber>
                   <operationtype>100</operationtype>
                   <operationstate>Success</operationstate>
                   <amount>90.00</amount>
                   <currency>RUB</currency>
                   <clientip>81.211.118.98</clientip>
                   <ipaddress>0.0.0.0</ipaddress>
                   <meantype_id>1</meantype_id>
                   <meantypename>VISA</meantypename>
                   <meansubtype>Classic</meansubtype>
                   <meannumber>411111****1111</meannumber>
                   <cardholder>TEST TESTOV</cardholder>
                   <cardexpirationdate>12/25</cardexpirationdate>
                   <issuebank>New Assist Bank</issuebank>
                   <bankcountry>Россия</bankcountry>
                   <responsecode>AS000</responsecode>
                   <message> </message>
                   <customermessage></customermessage>
                   <recommendation></recommendation>
                   <approvalcode>X26591</approvalcode>
                   <protocoltypename>NET</protocoltypename>
                   <processingname>BPCBel</processingname>
                   <operationdate>11.07.2022 07:23:02</operationdate>
                   <authresult>Y</authresult>
                   <authrequired>1</authrequired>
                   <slipno></slipno>
                   <threedsdata>
                       <version>1.0</version>
                       <alphaauthresult>Y</alphaauthresult>
                       <challenge>C</challenge>
                       <eci>5</eci>
                   </threedsdata>
                </operation>
                <operation>
                   <billnumber>5732614256223423.2</billnumber>
                   <operationtype>100</operationtype>
                   <operationstate>Success</operationstate>
                   <amount>10.00</amount>
                   <currency>RUB</currency>
                   <clientip>81.211.118.98</clientip>
                   <ipaddress>0.0.0.0</ipaddress>
                   <meantype_id>21</meantype_id>
                   <meantypename>Discount</meantypename>
                   <meansubtype></meansubtype>
                   <meannumber></meannumber>
                   <cardholder></cardholder>
                   <cardexpirationdate></cardexpirationdate>
                   <issuebank>UNKNOWN</issuebank>
                   <bankcountry>UNKNOWN</bankcountry>
                   <responsecode>AS000</responsecode>
                   <message> </message>
                   <customermessage></customermessage>
                   <recommendation></recommendation>
                   <approvalcode></approvalcode>
                   <protocoltypename></protocoltypename>
                   <processingname>Disc</processingname>
                   <operationdate>11.07.2022 07:23:08</operationdate>
                   <authresult></authresult>
                   <authrequired></authrequired>
                   <slipno></slipno>
                   <threedsdata>
                       <version></version>
                       <alphaauthresult></alphaauthresult>
                       <challenge></challenge>
                       <eci>7</eci>
                   </threedsdata>
                </operation>
        </order>
</result>

В формате SOAP:

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.paysecure.ru/ws/">
    <soapenv:Body>
        <ws:orderresultResponse>
            <orderresult>
                <order>
                    <ordernumber>2022.07.11-6</ordernumber>
                    <billnumber>5732614256223423</billnumber>
                    <testmode>0</testmode>
                    <ordercomment></ordercomment>
                    <orderamount>100.00</orderamount>
                    <ordercurrency>RUB</ordercurrency>
                    <firstname>Test</firstname>
                    <lastname>Testov</lastname>
                    <middlename>T.</middlename>
                    <email>test@assist.ru</email>
                    <orderdate>11.07.2022 07:23:02</orderdate>
                    <orderstate>Approved</orderstate>
                    <packetdate>11.07.2022 07:42</packetdate>
                    <signature></signature>
                    <checkvalue>65A46731208432C4018D42091E8E4F35</checkvalue>
                    <operation>
                        <billnumber>5732614256223423.1</billnumber>
                        <operationtype>100</operationtype>
                        <operationstate>Success</operationstate>
                        <amount>90.00</amount>
                        <currency>RUB</currency>
                        <clientip>81.211.118.98</clientip>
                        <ipaddress>0.0.0.0</ipaddress>
                        <meantype_id>1</meantype_id>
                        <meantypename>VISA</meantypename>
                        <meansubtype>Classic</meansubtype>
                        <meannumber>411111****1111</meannumber>
                        <cardholder>TEST TESTOV</cardholder>
                        <cardexpirationdate>12/25</cardexpirationdate>
                        <issuebank>New Assist Bank</issuebank>
                        <bankcountry>Россия</bankcountry>
                        <responsecode>AS000</responsecode>
                        <message> </message>
                        <customermessage> </customermessage>
                        <recommendation></recommendation>
                        <approvalcode>X26591</approvalcode>
                        <protocoltypename>NET</protocoltypename>
                        <processingname>BPCBel</processingname>
                        <operationdate>11.07.2022 07:23:02</operationdate>
                        <authresult>Y</authresult>
                        <authrequired>1</authrequired>
                        <slipno></slipno>
                        <threedsdata>
                            <version>1.0</version>
                            <alphaauthresult>Y</alphaauthresult>
                            <challenge>C</challenge>
                            <eci>5</eci>
                        </threedsdata>
                    </operation>
                    <operation>
                        <billnumber>5732614256223423.2</billnumber>
                        <operationtype>100</operationtype>
                        <operationstate>Success</operationstate>
                        <amount>10.00</amount>
                        <currency>RUB</currency>
                        <clientip>81.211.118.98</clientip>
                        <ipaddress>0.0.0.0</ipaddress>
                        <meantype_id>21</meantype_id>
                        <meantypename>Discount</meantypename>
                        <meansubtype></meansubtype>
                        <meannumber></meannumber>
                        <cardholder></cardholder>
                        <cardexpirationdate></cardexpirationdate>
                        <issuebank>UNKNOWN</issuebank>
                        <bankcountry>UNKNOWN</bankcountry>
                        <responsecode>AS000</responsecode>
                        <message> </message>
                        <customermessage> </customermessage>
                        <recommendation></recommendation>
                        <approvalcode></approvalcode>
                        <protocoltypename></protocoltypename>
                        <processingname>Disc</processingname>
                        <operationdate>11.07.2022 07:23:08</operationdate>
                        <authresult></authresult>
                        <authrequired></authrequired>
                        <slipno></slipno>
                        <threedsdata>
                            <version></version>
                            <alphaauthresult></alphaauthresult>
                            <challenge></challenge>
                            <eci>7</eci>
                        </threedsdata>
                    </operation>
                </order>
            </orderresult>
        </ws:orderresultResponse>
    </soapenv:Body>

В формате JSON:

{
    "orderresult": {
        "orders": [
            {
                "operations": [
                    {
                        "customermessage": " ",
                        "message": " ",
                        "operationdate": "11.07.2022 07:23:02",
                        "operationtype": 100,
                        "authrequired": "1",
                        "cardexpirationdate": "12/25",
                        "operationstate": "Success",
                        "threedsdata": {
                            "version": "1.0",
                            "eci": "5",
                            "alphaauthresult": "Y",
                            "challenge": "C"
                        },
                        "recommendation": "",
                        "processingname": "BPCBel",
                        "meannumber": "411111****1111",
                        "meantype_id": 1,
                        "authresult": "Y",
                        "clientip": "81.211.118.98",
                        "ipaddress": "0.0.0.0",
                        "amount": 90,
                        "responsecode": "AS000",
                        "meantypename": "VISA",
                        "protocoltypename": "NET",
                        "bankcountry": "Россия",
                        "cardholder": "TEST TESTOV",
                        "approvalcode": "X26591",
                        "slipno": "",
                        "issuebank": "New Assist Bank",
                        "currency": "RUB",
                        "billnumber": "5732614256223423.1",
                        "meansubtype": "Classic"
                    },
                    {
                        "customermessage": " ",
                        "message": " ",
                        "operationdate": "11.07.2022 07:23:08",
                        "operationtype": 100,
                        "authrequired": "",
                        "cardexpirationdate": "",
                        "operationstate": "Success",
                        "threedsdata": {
                            "version": "",
                            "eci": "7",
                            "alphaauthresult": "",
                            "challenge": ""
                        },
                        "recommendation": "",
                        "processingname": "Disc",
                        "meannumber": "",
                        "meantype_id": 21,
                        "authresult": "",
                        "clientip": "81.211.118.98",
                        "ipaddress": "0.0.0.0",
                        "amount": 10,
                        "responsecode": "AS000",
                        "meantypename": "Discount",
                        "protocoltypename": "",
                        "bankcountry": "UNKNOWN",
                        "cardholder": "",
                        "approvalcode": "",
                        "slipno": "",
                        "issuebank": "UNKNOWN",
                        "currency": "RUB",
                        "billnumber": "5732614256223423.2",
                        "meansubtype": ""
                    }
                ],
                "testmode": 0,
                "customer": {
                    "lastname": "Testov",
                    "firstname": "Test",
                    "middlename": "T.",
                    "email": "test@assist.ru"
                },
                "orderdate": "11.07.2022 07:23:02",
                "packetdate": "11.07.2022 07:29",
                "orderamount": 100,
                "ordercomment": "",
                "ordercurrency": "RUB",
                "orderstate": "Approved",
                "signature": "",
                "checkvalue": "65A46731208432C4018D42091E8E4F35",
                "billnumber": "5732614256223423",
                "ordernumber": "2022.07.11-6"
            }
        ]
    }

Пример пакета результата авторизации операции скидки, отправленного на сервер предприятия

11.07.2022 07:15:55 Request Operation_ID:6000929 TO URL:https://<SERVER-NAME>/merchant-services/service
Params: merchant_id:732614;ordernumber:2022.07.11-5;billnumber:5732614256223415.2;testmode:0;ordercomment:;orderamount:100.00;ordercurrency:RUB;amount:10.00;currency:RUB;rate:1;firstname:Test;lastname:Testov;middlename:T.;email:null@assist.ru;clientip:81.211.118.98;ipaddress:0.0.0.0;meantype_id:21;meantypename:Discount;meansubtype:;meannumber:;cardholder:;cardexpirationdate:;issuebank:UNKNOWN;bankcountry:UNKNOWN;orderdate:11.07.2022 07:15:46;orderstate:Approved;responsecode:AS000;message:;customermessage:;recommendation:SUCCESSFUL AUTHORIZATION;approvalcode:;protocoltypename:;processingname:Discount;operationtype:100;operationdate:11.07.2022 07:15:51;authresult:;authrequired:;slipno:;packetdate:11.07.2022 07:15:55;signature:;checkvalue:F0D84B730CCF85C264A9C2289EEC9113;token:;version:;alphaauthresult:;challenge:;eci:7;

Пример пакета результата авторизации операции оплаты, отправленного на сервер предприятия 

11.07.2022 07:23:15 Request Operation_ID:6000930 TO URL:https:// URL:https://<SERVER-NAME>/merchant-services/service
Params: merchant_id:732614;ordernumber:2022.07.11-6;billnumber:5732614256223423.1;testmode:0;ordercomment:;orderamount:100.00;ordercurrency:RUB;amount:90.00;currency:RUB;rate:1;firstname:Test;lastname:Testov;middlename:T.;email:null@assist.ru;clientip:81.211.118.98;ipaddress:0.0.0.0;meantype_id:1;meantypename:VISA;meansubtype:Classic;meannumber:411111****1111;cardholder:TEST TESTOV;cardexpirationdate:12/25;issuebank:New Assist Bank;bankcountry:Россия;orderdate:11.07.2022 07:23:02;orderstate:Approved;responsecode:AS000;message:;customermessage:;recommendation:SUCCESSFUL AUTHORIZATION;approvalcode:X26591;protocoltypename:NET;processingname:BPCBel;operationtype:100;operationdate:11.07.2022 07:23:02;authresult:Y;authrequired:1;slipno:;packetdate:11.07.2022 07:23:15;signature:;checkvalue:7C8A939B29D3384F8DB6890452506A27;token:;version:1.0;alphaauthresult:Y;challenge:C;eci:5;

Промоигры

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

Конкретные условия промоигры обсуждаются предприятием со службой технической поддержки АПК Ассист, необходимые данные по промоигре предприятие передает сотрудникам отдела технической поддержки АПК Ассист для корректной настройки системы.

Если условия игры предполагают оплаты нескольким разным предприятиям, то все эти предприятия участвуют в промоигре одинаково, без каких-либо особенностей.

Для оплаты заказа с участием плательщика в промоигре нужно передать в запросе дополнительный параметр «PROMOGAME». Значением параметра является наименование конкретной промоигры. Уникальное наименование промоигры генерируется службой технической поддержки АПК Ассист и передается предприятию (также наименование может быть выбрано совместно с предприятием). При отсутствии в запросе дополнительного параметра «PROMOGAME» по согласованию с предприятием на стороне АПК Ассист можно настроить отказ в платеже или прием платежа без участия в игре.

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

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

Также следует разработать специальные шаблоны писем покупателю о результате платежа с дополнительной информацией об участии в игре.


Наверх