Page History
...
Для скидки необходимо разработать специальные шаблоны платежных страниц или доработать индивидуальные шаблоны. На платежных страницах должна отображаться информация об условиях скидки.
Основная часть настроек скидок выполняется на стороне АПК Ассист. Для этого предприятию следует сообщить сотрудникам отдела технической поддержки АПК Ассист точные параметры скидки:
- тип скидки с передачей или без передачи параметра «PROMONAME»;
- время действия скидки;
- текст сообщения для покупателя;
- размер скидки в процентах и правила округления при вычислении суммы скидки, а также максимально возможная сумма скидки;
- правила выбора скидки, если имеется несколько разных акций со скидками (суммирование скидок или использование максимальной из нескольких);
- типы карт, которые участвуют в акции.
Следует иметь в виду, что оплата со скидкой в АПК Ассист будет состоять из двух операций: одной реальной на сумму заказа за вычетом скидки и второй виртуальной на сумму скидки. Обе операции будут отображаться в ЛК предприятия, а также в ответах веб-сервисов результатов платежей. В чеке для покупателя будет указана общая сумма заказа, оплаченная сумма и скидка.
Примеры ответов на запрос получения результатов операций по номеру заказа
В формате XML:
| Code Block | ||
|---|---|---|
| ||
<?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:
| Code Block | ||
|---|---|---|
| ||
<?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:
| Code Block | ||
|---|---|---|
| ||
{
"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"
}
]
} |
Пример пакета результата авторизации операции скидки, отправленного на сервер предприятия
| Code Block | ||
|---|---|---|
| ||
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; |
Пример пакета результата авторизации операции оплаты, отправленного на сервер предприятия
| Code Block | ||
|---|---|---|
| ||
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; |
Промоигры
Промоигры представляют собой рекламные акции, которые предусматривают розыгрыш призов для покупателей в зависимости от количества покупок в определенных магазинах и оплаты этих покупок определенными типами карт. В качестве призов могут рассматриваться, например, промокоды, а также определенные товары или услуги.
Конкретные условия промоигры обсуждаются предприятием со службой технической поддержки АПК Ассист, необходимые данные по промоигре предприятие передает сотрудникам отдела технической поддержки АПК Ассист для корректной настройки системы.
| Note |
|---|
Если условия игры предполагают оплаты нескольким разным предприятиям, то все эти предприятия участвуют в промоигре одинаково, без каких-либо особенностей. |
Для оплаты заказа с участием плательщика в промоигре нужно передать в запросе дополнительный параметр «PROMOGAME». Значением параметра является наименование конкретной промоигры. Уникальное наименование промоигры генерируется службой технической поддержки АПК Ассист и передается предприятию (также наименование может быть выбрано совместно с предприятием). При отсутствии в запросе дополнительного параметра «PROMOGAME» по согласованию с предприятием на стороне АПК Ассист можно настроить отказ в платеже или прием платежа без участия в игре.
В отличие от других типов рекламных акций, при использовании промоигр конкретные возможности реализации различных функций промоигры обсуждаются с предприятием и по результатам оговариваются все необходимые настройки на стороне АПК Ассист и на стороне предприятия. Реализация итогов промоигр в виде призов остается на стороне предприятия.
Для промоигры необходимо разработать специальные шаблоны платежных страниц или доработать индивидуальные шаблоны. На платежных страницах должна отображаться информация об игре, ее правилах (или ссылкой на них).
Также следует разработать специальные шаблоны писем покупателю о результате платежа с дополнительной информацией об участии в игре.