Платежные web-сервисы:EntryPoint — различия между версиями
[непроверенная версия] | [досмотренная версия] |
Aefremov (обсуждение | вклад) (→Sberbank) |
Gavrilov (обсуждение | вклад) (→Tinkoff (Т-Банк)) |
||
(не показаны 32 промежуточные версии 4 участников) | |||
Строка 4: | Строка 4: | ||
Модуль '''EntryPoint''' предоставляет возможность покупателю/агентству выбрать способ оплаты путевок. Оплата путевок может осуществляться в экранах «Список заявок» (OrderList.aspx) и «Путевка» (OrderInfo.aspx). <br /> | Модуль '''EntryPoint''' предоставляет возможность покупателю/агентству выбрать способ оплаты путевок. Оплата путевок может осуществляться в экранах «Список заявок» (OrderList.aspx) и «Путевка» (OrderInfo.aspx). <br /> | ||
В данный момент доступны следующие способы оплаты: | В данный момент доступны следующие способы оплаты: | ||
− | * | + | * Alfabank |
− | * | + | * Sberbank |
− | * | + | * Tinkoff (Т-Банк) |
− | * | + | * Uniteller |
+ | * YandexPay | ||
+ | * Assist | ||
+ | * WebPay | ||
+ | * PayOnline | ||
==Установка== | ==Установка== | ||
Строка 219: | Строка 223: | ||
* '''name'''="Tinkoff" - название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля); | * '''name'''="Tinkoff" - название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля); | ||
* '''paymentSystem'''="Tinkoff" - название платежной системы. Одно из предопределенных значений: | * '''paymentSystem'''="Tinkoff" - название платежной системы. Одно из предопределенных значений: | ||
− | ** | + | ** Alfabank |
− | ** | + | ** Sberbank и SberbankMir, SberbankChildren |
− | ** | + | ** Tinkoff |
− | ** | + | ** Uniteller и UnitellerMir, UnitellerChildren |
+ | ** Assist | ||
+ | ** WebPay | ||
+ | ** PayOnline | ||
* '''LogoLink''' - расположение логотипа способа оплаты; | * '''LogoLink''' - расположение логотипа способа оплаты; | ||
* '''maximumAmount''' - максимальный размер платежа; | * '''maximumAmount''' - максимальный размер платежа; | ||
Строка 229: | Строка 236: | ||
Если значение skipDescriptionPage=false, то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.<br /> | Если значение skipDescriptionPage=false, то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.<br /> | ||
* '''link''' - ссылка на платежную систему, по которой доступен данный способ оплаты. | * '''link''' - ссылка на платежную систему, по которой доступен данный способ оплаты. | ||
+ | |||
===Настройки в секции paymentAvailabilities модуля EntryPoint=== | ===Настройки в секции paymentAvailabilities модуля EntryPoint=== | ||
В данной секции происходит настройка описания доступных способов оплаты, заданных в секции paymentMethods, текущему пользователю. | В данной секции происходит настройка описания доступных способов оплаты, заданных в секции paymentMethods, текущему пользователю. | ||
Строка 238: | Строка 246: | ||
* '''paymentMethodCode''' - идентификатор способа оплаты (''code'') из секции '''paymentMethod'''; | * '''paymentMethodCode''' - идентификатор способа оплаты (''code'') из секции '''paymentMethod'''; | ||
* '''countryCode''' - ограничение доступности метода оплаты по ключу страны (''cn_key'' из таблицы ''tbl_country''). Может быть пустым - доступен для всех стран; | * '''countryCode''' - ограничение доступности метода оплаты по ключу страны (''cn_key'' из таблицы ''tbl_country''). Может быть пустым - доступен для всех стран; | ||
− | * '''filialCode''' - ограничение доступности метода оплаты по коду партнера-филиала из его карточки. Может быть пустым - доступен для всех филиалов; | + | * '''filialCode''' - ограничение доступности метода оплаты по коду партнера-филиала из его карточки (поле ''PR_COD''). Может быть пустым - доступен для всех филиалов; |
* '''consumerCode''' - ограничение по типу забронировавшего: турист или агентство. ''Person'' - для частных лиц, ''Agency'' - для турагентств; | * '''consumerCode''' - ограничение по типу забронировавшего: турист или агентство. ''Person'' - для частных лиц, ''Agency'' - для турагентств; | ||
* '''isAvailable''' - включено или выключено это ограничение. Значение ''false'' равносильно отсутствию строки в секции; | * '''isAvailable''' - включено или выключено это ограничение. Значение ''false'' равносильно отсутствию строки в секции; | ||
Строка 304: | Строка 312: | ||
| 5 | | 5 | ||
+ | |Ссылка на платежный шлюз <br> | ||
+ | | | ||
+ | Ссылка на платежный шлюз | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="paymentSystemLoginURL" value="https://ws.egopay.ru/order/v2/" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 6 | ||
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br> | |Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br> | ||
| | | | ||
Строка 314: | Строка 332: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 7 |
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br> | |Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br> | ||
| | | | ||
Строка 325: | Строка 343: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 8 |
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''. | | Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''. | ||
Обязательная настройка. | Обязательная настройка. | ||
Строка 335: | Строка 353: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 9 |
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''. | | Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''. | ||
Обязательная настройка. | Обязательная настройка. | ||
Строка 345: | Строка 363: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 10 |
| Настройка, включающая расчет через Мастер финанс. | | Настройка, включающая расчет через Мастер финанс. | ||
| | | | ||
Строка 356: | Строка 374: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 11 |
| Настройка, определяющая '''тип операции при проведении платежа'''. | | Настройка, определяющая '''тип операции при проведении платежа'''. | ||
Обязательная настройка. | Обязательная настройка. | ||
Строка 366: | Строка 384: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 12 |
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''. | | Настройка, определяющая '''тип операции при проведении платежа для комиссий'''. | ||
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>). | | '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>). | ||
Строка 375: | Строка 393: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 13 |
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''. | | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''. | ||
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>). | | Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>). | ||
Строка 385: | Строка 403: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 14 |
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''. | | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''. | ||
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>). | | Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>). | ||
Строка 395: | Строка 413: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 15 |
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''. | | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''. | ||
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>). | | Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>). | ||
Строка 404: | Строка 422: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 16 |
| Настройка, определяющая '''адрес электронной почты по умолчанию'''. | | Настройка, определяющая '''адрес электронной почты по умолчанию'''. | ||
|Используется в том случае, если не указан адрес электронной почты главного туриста. | |Используется в том случае, если не указан адрес электронной почты главного туриста. | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
<add key="defaultEmail" value="" /> | <add key="defaultEmail" value="" /> | ||
− | |||
</syntaxhighlight> | </syntaxhighlight> | ||
+ | |}<br /> | ||
+ | =====Формирование чеков Alfabank===== | ||
+ | Настройки для формирования чека задаются в секции <code><Alfabank></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br /> | ||
+ | Обратите внимание, настройки являются обязательными. | ||
+ | {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" | ||
+ | |||
+ | |- style="background-color:#F2F2F2" | ||
+ | ! width="2%" | № | ||
+ | ! width="28%" | Описание | ||
+ | ! width="35%" | Значение | ||
+ | ! width="35%" | Настройка | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 1 | ||
+ | | '''Система налогообложения''' | ||
+ | | Значения: | ||
+ | general — общая | ||
+ | simple_income — упрощенная (доходы) | ||
+ | simple_profit — упрощенная (доходы минус расходы) | ||
+ | patent — патентная | ||
+ | unified_agricultural — единый сельскохозяйственный налог | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="TaxationCode" value="general" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 2 | ||
+ | | '''Ставка НДС''' | ||
+ | | Значения: | ||
+ | no — без НДС | ||
+ | 0 — 0% | ||
+ | 10 — 10% | ||
+ | 20 — 20% | ||
+ | 10/110 — 10/110 | ||
+ | 20/120 — 20/120 | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="Tax" value="no" /> | ||
+ | </syntaxhighlight> | ||
|}<br /> | |}<br /> | ||
+ | Обратите внимание, что для каждой услуги отправляется на уровне кода:</br> | ||
+ | * typename - ServiceType согласно ключу SvKey, нигде в чеке не фигурирует;</br> | ||
+ | * number - ключ услуги в БД;</br> | ||
+ | * quantity - 1(услуга);</br> | ||
+ | * name - "Туристическая услуга по путевке {код договора}";</br> | ||
+ | * amount - сумма оплаты по услуге и валюта;</br> | ||
+ | * taxation_item_settlement_method - "full_prepayment";</br> | ||
+ | * taxation_item_type - "service";</br> | ||
+ | * taxation_system - "general" по умолчанию, если не указано иное в конфиге;</br> | ||
+ | * taxes - налог, где</br> | ||
+ | ** amount - вычисляется согласно выбранной системе расчета налога и валюта;</br> | ||
+ | ** percentage - "no" по умолчанию, иначе - из конфига "20/120" и т.д.;</br> | ||
+ | ** type - "vat";</br> | ||
+ | ** source - "shop"</br> | ||
+ | |||
+ | [[Файл: mb_030.png|left|Предупреждение]] <BR> Обратите внимание, что для корректной записи платежей в Мастер Тур, необходимо настроить автоматическое подтверждение платежа. Для этого необходимо обратиться в техподдержку Альфа-Банка. | ||
+ | Существует возможность также подтверждать платежи вручную. Подробнее можно ознакомиться тут https://ecom.alfabank.ru/assets/instructions/merchantManual/pages/index/general_description.html#koordinati_podkljuchenija или запросить информацию в технической поддержке Альфа-Банка | ||
====Sberbank==== | ====Sberbank==== | ||
Строка 484: | Строка 558: | ||
| 7 | | 7 | ||
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''. | | Настройка, определяющая '''тип операции при проведении платежа для комиссий'''. | ||
− | | '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>). | + | | '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).</br> |
+ | <br /><font style="color:red">''Внимание!''</font><br /> | ||
+ | Если данная настройка не заполнена, то значения настроек '''NewDogovorServiceServiceListKey''', '''NewDogovorServiceSvKey''', '''NewDogovorServicePartnerKey''' обязательно оставить незаполненными. | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
<add key="paymentOperationCommissionId" value="6" /> | <add key="paymentOperationCommissionId" value="6" /> | ||
Строка 548: | Строка 624: | ||
<add key="AddPaymentsToMasterFinance" value="false"/> | <add key="AddPaymentsToMasterFinance" value="false"/> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
+ | |||
|} | |} | ||
<br /> | <br /> | ||
− | ====Tinkoff==== | + | ====Tinkoff (Т-Банк)==== |
− | Настройки задаются в секции <code>< | + | Настройки задаются в секции <code><paymentMethods></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br /> |
+ | |||
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" | {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" | ||
Строка 565: | Строка 643: | ||
| 1 | | 1 | ||
− | | ''' | + | | '''Платежный метод''' |
Обязательная настройка. | Обязательная настройка. | ||
− | | | + | | способ оплаты в платежной системе «Tinkoff (Т-Банк)». |
+ | *'''code="1"''' – идентификатор платежного метода, должен быть уникальным. Используется в других секциях, для ссылки на данный метод оплаты; | ||
+ | *'''name="Tinkoff"''' – название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля); | ||
+ | *'''paymentSystem="Tinkoff"''' – название платежной системы. | ||
+ | *'''LogoLink''' – расположение логотипа способа оплаты; | ||
+ | *'''maximumAmount''' – максимальный размер платежа; | ||
+ | *'''skipDescriptionPage''' – отображать экран редактирования оплаты или сразу выполнять платеж с текущими значениями. | ||
+ | **Если значение '''skipDescriptionPage=true''', то сразу происходит переход к оплате. | ||
+ | **Если значение '''skipDescriptionPage=false''', то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз. | ||
+ | *'''displayWindowWithEditingRequestData''' – настройка включающая проверку e-mail и телефона плательщика, при отсутствии выводит модальное окно с просьбой ввести e-mail и телефон плательщика. после ввода данных отправлять на оплату. | ||
+ | **'''false''' – проверка не проводится | ||
+ | **'''true''' – проверка проводится | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add | + | <add code="12" name="Платформа Tinkoff" logoLink="~/Content/logos/logoTinkoff.png" |
+ | maximumAmount="1000000" | ||
+ | skipDescriptionPage="false" displayWindowWithEditingRequestData="true" paymentSystem="Tinkoff" /> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
+ | |} | ||
+ | <br /> | ||
+ | |||
+ | Настройки задаются в секции <code><Tinkoff></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br /> | ||
+ | {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" | ||
+ | |||
+ | |- style="background-color:#F2F2F2" | ||
+ | |||
+ | ! width="2%" | № | ||
+ | ! width="28%" | Описание | ||
+ | ! width="35%" | Значение | ||
+ | ! width="35%" | Настройка | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
Строка 577: | Строка 680: | ||
| '''Адрес платежной службы''' | | '''Адрес платежной службы''' | ||
Обязательная настройка. | Обязательная настройка. | ||
− | | Адрес сервиса оплаты через карту банка | + | | Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)». |
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/> | <add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/> | ||
Строка 587: | Строка 690: | ||
| '''Адрес для оплаты по QR коду''' | | '''Адрес для оплаты по QR коду''' | ||
Обязательная настройка. | Обязательная настройка. | ||
− | | Адрес сервиса оплаты через карту банка | + | | Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)» по QR коду. |
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/> | <add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/> | ||
Строка 617: | Строка 720: | ||
| '''Идентификатор терминала''' | | '''Идентификатор терминала''' | ||
Обязательная настройка. | Обязательная настройка. | ||
− | | Параметр '''Терминал''' из раздела Терминалы в л/к сервиса | + | | Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)». |
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
<add key="TerminalKey" value="1587990738"/> | <add key="TerminalKey" value="1587990738"/> | ||
Строка 627: | Строка 730: | ||
| '''Пароль терминала''' | | '''Пароль терминала''' | ||
Обязательная настройка. | Обязательная настройка. | ||
− | | Параметр '''Пароль''' из раздела Терминалы в л/к сервиса | + | | Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)». |
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/> | <add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/> | ||
Строка 635: | Строка 738: | ||
| 7 | | 7 | ||
− | | Настройка, определяющая '''язык''' окна платежной формы | + | | Настройка, определяющая '''язык''' окна платежной формы «Tinkoff (Т-Банк)». |
Обязательная настройка. | Обязательная настройка. | ||
| | | | ||
Строка 784: | Строка 887: | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
<add key="NewDogovorServicePartnerKey" value="12921" /> | <add key="NewDogovorServicePartnerKey" value="12921" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | |21 | ||
+ | | Настройки, определяющие способ расчета. Если значение не передано, по умолчанию будет передаваться ''full_payment'' – полный расчет. | ||
+ | * Если сумма, которую мы оплачиваем меньше суммы, которую нужно оплатить, способ расчета определяется следующим образом: | ||
+ | ** Если ''PaymentMethodPrepayment'' имеет значение, то берем его. Если он пуст, то берем ''PaymentMethodMain'', если и он пуст, то передаем пустое значение (а на стороне Тинькофф это будет ''full_payment'') | ||
+ | * Если по договору уже есть какая-то ранее оплаченная сумма, то способ расчета считается следующим образом: | ||
+ | ** Если сумма, которую мы оплачиваем равна сумме, которую нужно оплатить, берем ''PaymentMethodFull''. Если он пуст, то берем ''PaymentMethodMain'', если и он пуст, то передаем пустое значение (а на стороне Тинькофф это будет ''full_payment'') | ||
+ | * Если у нас нет ранее оплаченной суммы, то способ расчета считается следующим образом: | ||
+ | ** Если сумма, которую мы оплачиваем равна сумме, которую нужно оплатить, берем ''PaymentMethodMain''. Если он пуст, то передаем пустое значение (а на стороне Тинькофф это будет ''full_payment'') | ||
+ | | Возможные значения: | ||
+ | * '''full_prepayment''' – предоплата 100% | ||
+ | * '''prepayment''' – предоплата | ||
+ | * '''advance''' – аванс | ||
+ | * '''full_payment''' – полный расчет | ||
+ | * '''partial_payment''' – частичный расчет и кредит | ||
+ | * '''credit''' – передача в кредит | ||
+ | * '''credit_payment''' – оплата кредита | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="PaymentMethodMain" value="prepayment" /> | ||
+ | <add key="PaymentMethodPrepayment" value="full_prepayment" /> | ||
+ | <add key="PaymentMethodFull" value="" /> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
|} | |} | ||
Строка 1074: | Строка 1201: | ||
| 22 | | 22 | ||
+ | | Настройка, включающая расчет через Мастер финанс. | ||
+ | | | ||
+ | * '''false''' - расчет через мастер финанс не включен; | ||
+ | * '''true''' - расчет через мастер финанс включен. | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="AddPaymentsToMasterFinance" value="false"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 23 | ||
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''. | | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''. | ||
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>). | | Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>). | ||
Строка 1082: | Строка 1220: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 24 |
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''. | | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''. | ||
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>). | | Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>). | ||
Строка 1091: | Строка 1229: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 25 |
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''. | | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''. | ||
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>). | | Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>). | ||
Строка 1100: | Строка 1238: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 26 |
| Настройка, задающая форму оплаты на шлюзе Uniteller | | Настройка, задающая форму оплаты на шлюзе Uniteller | ||
| "All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП | | "All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП | ||
Строка 1110: | Строка 1248: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 27 |
| Тип отображения комиссии платежной системы в фискальном чеке.<br> | | Тип отображения комиссии платежной системы в фискальном чеке.<br> | ||
Строка 1121: | Строка 1259: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 28 |
| Наименование позиции в чеке для комиссии для <add key="ComissionShowModeInVoucher" value ="1"/>.<br> | | Наименование позиции в чеке для комиссии для <add key="ComissionShowModeInVoucher" value ="1"/>.<br> | ||
Строка 1129: | Строка 1267: | ||
<add key="ComissionTextInVoucher" value ="Юнителлер комиcсия"/> | <add key="ComissionTextInVoucher" value ="Юнителлер комиcсия"/> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
+ | |||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 29 |
| Вид формирования чека <br> | | Вид формирования чека <br> | ||
Строка 1143: | Строка 1282: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 30 |
| Наименование услуги в чеке <br> | | Наименование услуги в чеке <br> | ||
Строка 1210: | Строка 1349: | ||
* Добавлены программные интерфейсы для новых сценариев.</br> | * Добавлены программные интерфейсы для новых сценариев.</br> | ||
* Для интерфейсов версии 2.0 изменен формат фискального чека.</br> | * Для интерфейсов версии 2.0 изменен формат фискального чека.</br> | ||
+ | ====YandexPay==== | ||
+ | Настройки задаются в секции <code><YandexPay></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br /> | ||
+ | {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" | ||
− | |||
− | |||
− | |||
− | |||
|- style="background-color:#F2F2F2" | |- style="background-color:#F2F2F2" | ||
Строка 1223: | Строка 1361: | ||
! width="35%" | Настройка | ! width="35%" | Настройка | ||
− | |- style="vertical-align:text-top | + | |- style="vertical-align:text-top |
+ | |||
| 1 | | 1 | ||
− | | | + | | '''Таймаут запроса''' |
Обязательная настройка. | Обязательная настройка. | ||
− | | | + | | Время ожидания ответа от сервера в миллисекундах. |
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="RequestTimeout" value="10" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |
+ | |- style="vertical-align | ||
+ | |||
+ | |||
| 2 | | 2 | ||
− | | | + | | '''API-ключ''' |
Обязательная настройка. | Обязательная настройка. | ||
− | | | + | | Уникальный ключ API для доступа к сервисам Yandex Pay. |
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="ApiKey" value="a8412f07-5583-4b3e-abe1-06ad6733ea1d" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |
+ | |- style="vertical-align | ||
+ | |||
+ | |||
| 3 | | 3 | ||
− | | | + | | '''URL создания заказа''' |
− | | | + | Обязательная настройка. |
+ | | URL для запроса на создание ссылки на оплату заказа. | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="CreateOrderUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
+ | |||
+ | |||
| 4 | | 4 | ||
− | | | + | | '''URL получения деталей заказа''' |
Обязательная настройка. | Обязательная настройка. | ||
− | | | + | | URL для запроса на получение деталей заказа. |
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="GetOrderDetailsUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
+ | |||
+ | |||
| 5 | | 5 | ||
− | | | + | | '''Ставка НДС''' |
− | | | + | Обязательная настройка. |
− | * ''' | + | | Значение ставки НДС: |
− | * ''' | + | |
− | + | * '''1''' - НДС по ставке 20% | |
+ | * '''2''' - НДС по ставке 10% | ||
+ | * '''3''' - НДС по расчетной ставке 20/120 | ||
+ | * '''4''' - НДС по расчетной ставке 10/110 | ||
+ | * '''5''' - НДС по ставке 0% | ||
+ | * '''6''' - Без НДС | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="Tax" value="1" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
+ | |||
| 6 | | 6 | ||
− | | | + | | '''Доступные методы оплаты''' |
− | + | Опциональная настройка. | |
− | | ''' | + | | Методы оплаты, доступные на платежной форме Yandex Pay: |
+ | |||
+ | * '''0''' - CARD | ||
+ | * '''1''' - SPLIT | ||
+ | * '''2''' - CARD, SPLIT | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="AvailablePaymentMethods" value="2" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
+ | |- style="vertical-align | ||
− | |||
| 7 | | 7 | ||
− | | | + | | '''Сплит при наличии комиссии''' |
− | | ''' | + | Опциональная настройка. |
+ | | Указывает, доступен ли сплит, когда есть комиссия: | ||
+ | |||
+ | * '''true''' - доступен | ||
+ | * '''false''' - не доступен | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="AvailableSplitMethodWhenCommission" value="false" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
+ | |- style="vertical-align | ||
− | |||
| 8 | | 8 | ||
− | | | + | | '''Ключ пользователя''' |
− | | | + | Обязательная настройка. |
− | + | | Ключ пользователя, к которому привязывается оплата. | |
− | |||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="masterTourUser" value="106" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
+ | |||
| 9 | | 9 | ||
− | | | + | | '''Ключ филиала''' |
− | | | + | Обязательная настройка. |
− | + | | Ключ филиала, к которому привязывается оплата. | |
− | |||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="paymentFilialKey" value="7" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
+ | |||
| 10 | | 10 | ||
− | | | + | | '''Ключ отдела''' |
− | | Ключ | + | Обязательная настройка. |
+ | | Ключ отдела (кассы), к которому привязывается оплата. | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="departmentKey" value="7" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
+ | |||
| 11 | | 11 | ||
− | | | + | | '''Тип операции при проведении платежа''' |
− | | Ключ | + | Обязательная настройка. |
+ | | Ключ операции из таблицы PaymentOperations, определяющий тип операции при проведении платежа. | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="PaymentOperationId" value="36" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
+ | |||
| 12 | | 12 | ||
− | | | + | | '''Тип операции для комиссий''' |
− | | Ключ | + | Опциональная настройка. |
+ | | Ключ операции из таблицы PaymentOperations для комиссий. | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="paymentOperationCommissionId" value="7" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | | | + | |- style="vertical-align |
− | |||
− | |||
− | |||
− | |||
− | |||
− | | | + | | 13 |
+ | | '''Размер комиссии для агентств''' | ||
+ | Опциональная настройка. | ||
+ | | Размер комиссии для агентств в процентах. | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="addAgencyComission" value="10" /> | ||
+ | </syntaxhighlight> | ||
− | + | |- style="vertical-align | |
− | |||
− | |||
− | |||
− | |||
− | | | + | | 14 |
− | + | | '''Размер комиссии для частных лиц''' | |
− | + | Опциональная настройка. | |
− | | ''' | + | | Размер комиссии для частных лиц в процентах. |
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="addPersonalComission" value="" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |
− | + | |- style="vertical-align | |
− | | | + | |
− | + | ||
− | | ''' | + | | 15 |
+ | | '''Класс услуги для комиссии''' | ||
+ | Опциональная настройка. | ||
+ | | Класс услуги, добавляемой в путевку при наличии комиссии. | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="NewDogovorServiceSvKey" value="1055" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |
− | | | + | |- style="vertical-align |
− | | | + | |
− | | | + | |
+ | | 16 | ||
+ | | '''Услуга для комиссии''' | ||
+ | Опциональная настройка. | ||
+ | | Услуга, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="NewDogovorServiceServiceListKey" value="982" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
− | | | + | |
− | | | + | |
− | + | | 17 | |
− | | | + | | '''Партнер для комиссии''' |
+ | Опциональная настройка. | ||
+ | | Партнер, являющийся поставщиком для услуги, добавляемой в путевку при наличии комиссии. | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="NewDogovorServicePartnerKey" value="10760" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
− | | | + | |
− | | | + | |
− | | | + | | 18 |
− | * '''true''' - | + | | '''Расчеты через MasterFinance''' |
− | * '''false''' | + | Опциональная настройка. |
− | + | | Указывает, проводятся ли платежи через MasterFinance: | |
+ | |||
+ | * '''true''' - проводятся | ||
+ | * '''false''' - не проводятся | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="AddPaymentsToMasterFinance" value="false" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
+ | |||
− | | | + | | 19 |
− | | | + | | '''Система налогообложения''' |
Обязательная настройка. | Обязательная настройка. | ||
− | | ''' | + | | Указывает, какая система налогообложения будет использоваться при платежах: |
+ | |||
+ | * '''osn''' — общая СН | ||
+ | * '''usn_income''' — упрощенная СН (доходы) | ||
+ | * '''usn_income_outcome''' – упрощенная СН (доходы минус расходы) | ||
+ | * '''esn''' – единый сельскохозяйственный налог | ||
+ | * '''patent''' – патентная СН | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="TaxationCode" value="osn" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
+ | |||
− | | | + | | 20 |
− | | | + | | '''Идентификатор группы ККТ''' |
− | | | + | Обязательная настройка. |
+ | | Идентификатор группы контрольно-кассовой техники. | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="ReceiptGroupCode" value="2ca8430a-ff34-421a-b2aa-2071d79eb782" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
− | | | + | |
− | | | + | | 21 |
− | | | + | | '''Логин для авторизации в сервисе формирования чеков''' |
− | + | Обязательная настройка. | |
− | + | | Логин для авторизации в сервисе формирования чеков. | |
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="ReceiptLogin" value="7709624788" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
+ | |||
− | | | + | | 22 |
− | | | + | | '''Пароль для авторизации в сервисе формирования чеков''' |
− | | | + | Обязательная настройка. |
− | + | | Пароль для авторизации в сервисе формирования чеков. | |
− | |||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="ReceiptPassword" value="79161128982" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |- style="vertical-align | + | |- style="vertical-align |
+ | |||
− | | | + | | 23 |
− | | | + | | '''URL для авторизации в сервисе формирования чеков''' |
− | | | + | Обязательная настройка. |
+ | | URL для авторизации в сервисе формирования чеков. | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="ReceiptAuthUrl" value="https://fiscalization.evotor.ru/possystem/v5/getToken" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | |- style="vertical-align | |
− | |- style="vertical-align | + | | 24 |
− | + | | '''Почта для отправки чеков по умолчанию''' | |
− | | | + | Опциональная настройка. |
− | | | + | | Указывается почта, на которую будут приходить чеки, в случае отсутствия их в партнере или представителе партнера |
− | | | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | + | <add key="ReceiptClientDefaultEmail" value="peligrim@mail.ru" /> |
</syntaxhighlight> | </syntaxhighlight> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
− | |||
− | ==== | + | ====Assist==== |
− | Настройки задаются в секции <code>< | + | Настройки задаются в секции <code><Assist></code> файла <code>web.config</code> приложения '''EntryPoint'''. |
<br /><br /> | <br /><br /> | ||
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" | {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" | ||
Строка 1478: | Строка 1655: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | |||
| 1 | | 1 | ||
− | | | + | | Ключ интернет-магазина |
− | + | | '''Ключ магазина''', который предоставляет Assist | |
− | | ''' | + | | <syntaxhighlight lang="xml" enclose="div"> |
− | |<syntaxhighlight lang="xml" enclose="div"> | + | <add key="shopID" value="326055"/> |
− | <add key=" | ||
</syntaxhighlight> | </syntaxhighlight> | ||
+ | |||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
| 2 | | 2 | ||
− | | | + | | Логин для авторизации в системе Assist |
− | + | | '''Логин''' для авторизации, который предоставляет Assist. Необходимо добавить обе настройки. | |
− | | ''' | + | | <syntaxhighlight lang="xml" enclose="div"> |
− | |<syntaxhighlight lang="xml" enclose="div"> | + | <add key="shopLogin" value="login"/> |
− | <add key=" | ||
</syntaxhighlight> | </syntaxhighlight> | ||
+ | |||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
| 3 | | 3 | ||
− | | | + | | Пароль для авторизации в системе Assist |
− | | | + | | '''Пароль''' для авторизации, который предоставляет Assist |
− | |<syntaxhighlight lang="xml" enclose="div"> | + | | <syntaxhighlight lang="xml" enclose="div"> |
− | <add key=" | + | <add key="shopPassword" value="password"/> |
</syntaxhighlight> | </syntaxhighlight> | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
| 4 | | 4 | ||
− | | | + | | Логин для авторизации |
− | + | | '''Логин''' веб-сервиса, который предоставляет Assist | |
− | | ''' | + | | <syntaxhighlight lang="xml" enclose="div"> |
− | |<syntaxhighlight lang="xml" enclose="div"> | + | <add key="webServiceLogin" value=" login "/> |
− | <add key=" | ||
</syntaxhighlight> | </syntaxhighlight> | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
| 5 | | 5 | ||
− | | Настройка, | + | | Настройка, определяющая пользователя, к которому будет привязываться оплата |
− | | | + | | '''Ключ пользователя''' из таблицы '''[UserList]''', к которому привязывается оплата |
− | + | | <syntaxhighlight lang="xml" enclose="div"> | |
− | + | <add key="masterTourUser" value="100006"/> | |
− | |||
− | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | ||
</syntaxhighlight> | </syntaxhighlight> | ||
+ | |||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | |||
| 6 | | 6 | ||
− | | Настройка, определяющая | + | | Настройка, определяющая партнера, к которому будет привязываться оплата |
− | + | | '''Ключ партнера''' из таблицы '''[tbl_Partners]''', к которому привязывается оплата | |
− | | '''Ключ | + | | <syntaxhighlight lang="xml" enclose="div"> |
− | |<syntaxhighlight lang="xml" enclose="div"> | + | <add key="paymentFilialKey" value="1"/> |
− | <add key=" | + | </syntaxhighlight> |
− | </syntaxhighlight> | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | |||
| 7 | | 7 | ||
− | | Настройка, определяющая | + | | Настройка, определяющая отдел, к которому будет привязываться оплата |
− | | '''Ключ | + | | '''Ключ отдела (кассы)''' из таблицы '''[PrtDeps]''', к которому привязывается оплата |
− | |<syntaxhighlight lang="xml" enclose="div"> | + | | <syntaxhighlight lang="xml" enclose="div"> |
− | <add key=" | + | <add key="departmentKey" value="2"/> |
</syntaxhighlight> | </syntaxhighlight> | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | |||
| 8 | | 8 | ||
− | | | + | | Боевой/тестовый адрес. Откуда получать ответ. |
− | + | | '''Боевой адрес''', который предоставляет Assist | |
− | + | либо белорусский тестовый сервис:<br /> | |
− | + | ''https://test.paysec.by/orderstate/orderstate.cfm''<br /> | |
− | |<syntaxhighlight lang="xml" enclose="div"> | + | либо питерский тестовый сервис:<br /> |
− | <add key=" | + | ''https://payments.demo.paysecure.ru/orderstate/orderstate.cfm<br />'' |
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="assistGetTransaction" value="" /> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | |||
| 9 | | 9 | ||
− | | | + | | Секретное слово из личного кабинета |
− | | ''' | + | | '''Секретное слово''', которое указывается в личном кабинете в Assist |
− | + | | <syntaxhighlight lang="xml" enclose="div"> | |
− | + | <add key="salt" value="" /> | |
− | |<syntaxhighlight lang="xml" enclose="div"> | ||
− | <add key=" | ||
</syntaxhighlight> | </syntaxhighlight> | ||
+ | |- style="vertical-align:text-top" | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | |||
| 10 | | 10 | ||
− | | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''. | + | | Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему Assist |
− | | Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>). | + | | '''Код валюты''' из таблицы '''[Rates]''', в которой будет совершаться платеж |
− | |<syntaxhighlight lang="xml" enclose="div"> | + | | <syntaxhighlight lang="xml" enclose="div"> |
− | <add key="NewDogovorServiceServiceListKey" value="450" /> | + | <add key="assistPaymentsRate" value="рб" /> |
− | </syntaxhighlight> | + | </syntaxhighlight> |
− | + | ||
− | |- style="vertical-align:text-top" | + | |- style="vertical-align:text-top" |
− | + | | 11 | |
− | | 11 | + | | Настройка, определяющая тип операции при проведении платежа |
− | | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''. | + | | '''Ключ операции''' из таблицы '''[PaymentOperations]''' |
− | | Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>). | + | | <syntaxhighlight lang="xml" enclose="div"> |
− | |<syntaxhighlight lang="xml" enclose="div"> | + | <add key="paymentOperationId" value="1"/> |
− | <add key="NewDogovorServiceSvKey" value="1055" /> | + | </syntaxhighlight> |
− | </syntaxhighlight> | + | |
− | + | |- style="vertical-align:text-top" | |
− | |- style="vertical-align:text-top" | + | | 12 |
− | + | | Настройка, определяющая '''тип операции при проведении платежа для комиссий'''. | |
− | | 12 | + | | '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>). |
− | | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''. | + | |<syntaxhighlight lang="xml" enclose="div"> |
− | | Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>). | + | <add key="paymentOperationCommissionId" value="6" /> |
− | |<syntaxhighlight lang="xml" enclose="div"> | + | </syntaxhighlight> |
− | <add key="NewDogovorServicePartnerKey" value="12921" /> | + | |
− | </syntaxhighlight> | + | |
− | + | |- style="vertical-align:text-top" | |
− | |} | + | | 13 |
− | <br /> | + | | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств'''). |
− | + | | '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой). | |
− | ==Настройка индивидуальных подписей и ссылок для кнопки оплаты== | + | Комиссия указывается '''в процентах'''.<br /> |
− | Имеется возможность добавить индивидуальную подпись и ссылку к баннеру платежной системы. | + | Сумма оплаты вычисляется следующим образом:<br /> |
− | Необходимо добавить новые параметры в секции '''paymentMethods''' соответствующего способа оплаты: | + | Если из ''конечной суммы'' платежа в системе «PayOnline» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br /> |
− | <syntaxhighlight lang="xml" enclose="div"> | + | Пример:<br /> |
− | <add code="17" name="Оплатить с кешбек" logoLink="~/Content/themes/base/images/payCashback.jpg" | + | Стоимость путевки - '''100 у.е.''' <br /> |
− | header="Оплата тура для участников программы «Кешбэк по карте МИР»" | + | В настройке указана комиссия - '''50%'''.<br /> |
− | returnMoneyText = "В последствии можно будет вернуть часть средств" | + | Итоговая сумма платежа в системе «Assist» - '''200 у.е.'''<br /> |
− | paymentTermsText = "Условия оплаты туров по программе «Кешбэк по карте МИР»" | + | <code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки''). |
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="addAgencyComission" value="3,627" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 14 | ||
+ | | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц'''). | ||
+ | | '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой). | ||
+ | Комиссия указывается '''в процентах'''.<br /> | ||
+ | Сумма оплаты вычисляется следующим образом:<br /> | ||
+ | Если из ''конечной суммы'' платежа в системе «Assist» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br /> | ||
+ | Пример:<br /> | ||
+ | Стоимость путевки - '''100 у.е.''' <br /> | ||
+ | В настройке указана комиссия - '''50%'''.<br /> | ||
+ | Итоговая сумма платежа в системе «PayOnline» - '''200 у.е.'''<br /> | ||
+ | <code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки''). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="addPersonalComission" value="5" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 15 | ||
+ | | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''. | ||
+ | | Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="NewDogovorServiceServiceListKey" value="450" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 16 | ||
+ | | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''. | ||
+ | | Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="NewDogovorServiceSvKey" value="1055" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 17 | ||
+ | | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''. | ||
+ | | Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="NewDogovorServicePartnerKey" value="12921" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 18 | ||
+ | | Настройка, включающая расчет через Мастер Финанс. | ||
+ | | | ||
+ | * '''false''' - расчет через Мастер Финанс не включен; | ||
+ | * '''true''' - расчет через Мастер Финанс включен. | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="AddPaymentsToMasterFinance" value="false"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |} | ||
+ | |||
+ | ====Webpay==== | ||
+ | Настройки задаются в секции <code><Webpay></code> файла <code>web.config</code> приложения '''EntryPoint'''. | ||
+ | <br /><br /> | ||
+ | {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" | ||
+ | |||
+ | |- style="background-color:#F2F2F2" | ||
+ | |||
+ | ! width="2%" | № | ||
+ | ! width="28%" | Описание | ||
+ | ! width="35%" | Значение | ||
+ | ! width="35%" | Настройка | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 1 | ||
+ | | Идентификатор клиента в платежной системе | ||
+ | | предоставляется Webpay | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="storeID" value="344612596"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 2 | ||
+ | | Пароль клиента в платежной системе | ||
+ | | предоставляется Webpay | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="privateKey" value="37kfffkvjj" | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 3 | ||
+ | | Код платежного агента | ||
+ | | предоставляется Webpay | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="customerID" value="megatec-2" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 4 | ||
+ | | Настройка, определяющая пользователя, к которому будет привязываться оплата | ||
+ | | '''Ключ пользователя''' из таблицы '''[UserList]''', к которому привязывается оплата | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="masterTourUser" value="100006"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 5 | ||
+ | | Настройка, определяющая партнера, к которому будет привязываться оплата | ||
+ | | '''Ключ партнера''' из таблицы '''[tbl_Partners]''', к которому привязывается оплата | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="paymentFilialKey" value="1"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 6 | ||
+ | | Настройка, определяющая отдел, к которому будет привязываться оплата | ||
+ | | '''Ключ отдела (кассы)''' из таблицы '''[PrtDeps]''', к которому привязывается оплата | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="departmentKey" value="2"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 7 | ||
+ | | Откуда получать ответ. Тестовый адрес: https://sandbox.webpay.by | ||
+ | | адрес платежного сервиса | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="webPayGetTransaction" value="https://securesandbox.webpay.by" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 8 | ||
+ | | Режим тестирования | ||
+ | | Режим тестирования - 1, боевой режим - 0 | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="isTest" value="1" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 9 | ||
+ | | Настройка, определяющая тип операции при проведении платежа | ||
+ | | '''Ключ операции''' из таблицы '''[PaymentOperations]''' | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="paymentOperationId" value="1"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 10 | ||
+ | | Настройка, определяющая '''тип операции при проведении платежа для комиссий'''. | ||
+ | | '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="paymentOperationCommissionId" value="6" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 11 | ||
+ | | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств'''). | ||
+ | | '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой). | ||
+ | Комиссия указывается '''в процентах'''.<br /> | ||
+ | Сумма оплаты вычисляется следующим образом:<br /> | ||
+ | Если из ''конечной суммы'' платежа в системе «PayOnline» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br /> | ||
+ | Пример:<br /> | ||
+ | Стоимость путевки - '''100 у.е.''' <br /> | ||
+ | В настройке указана комиссия - '''50%'''.<br /> | ||
+ | Итоговая сумма платежа в системе «Assist» - '''200 у.е.'''<br /> | ||
+ | <code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки''). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="addAgencyComission" value="3,627" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 12 | ||
+ | | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц'''). | ||
+ | | '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой). | ||
+ | Комиссия указывается '''в процентах'''.<br /> | ||
+ | Сумма оплаты вычисляется следующим образом:<br /> | ||
+ | Если из ''конечной суммы'' платежа в системе «Assist» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br /> | ||
+ | Пример:<br /> | ||
+ | Стоимость путевки - '''100 у.е.''' <br /> | ||
+ | В настройке указана комиссия - '''50%'''.<br /> | ||
+ | Итоговая сумма платежа в системе «PayOnline» - '''200 у.е.'''<br /> | ||
+ | <code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки''). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="addPersonalComission" value="5" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 13 | ||
+ | | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''. | ||
+ | | Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="NewDogovorServiceServiceListKey" value="450" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 14 | ||
+ | | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''. | ||
+ | | Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="NewDogovorServiceSvKey" value="1055" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 15 | ||
+ | | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''. | ||
+ | | Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="NewDogovorServicePartnerKey" value="12921" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 16 | ||
+ | | Настройка, включающая расчет через Мастер Финанс. | ||
+ | | | ||
+ | * '''false''' - расчет через Мастер Финанс не включен; | ||
+ | * '''true''' - расчет через Мастер Финанс включен. | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="AddPaymentsToMasterFinance" value="false"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |} | ||
+ | <br /> | ||
+ | |||
+ | ====PayOnline==== | ||
+ | Настройки задаются в секции <code><PayOnline></code> файла <code>web.config</code> приложения '''EntryPoint'''. | ||
+ | <br /><br /> | ||
+ | {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" | ||
+ | |||
+ | |- style="background-color:#F2F2F2" | ||
+ | |||
+ | ! width="2%" | № | ||
+ | ! width="28%" | Описание | ||
+ | ! width="35%" | Значение | ||
+ | ! width="35%" | Настройка | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 1 | ||
+ | | '''Ключ сайта'''. | ||
+ | Обязательная настройка. | ||
+ | | '''Merchant ID''' сайта в системе «PayOnline». | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="merchantId" value="2898" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 2 | ||
+ | | '''Ключ'''. | ||
+ | Обязательная настройка. | ||
+ | | '''Security key''' в ''Параметрах интеграции'' сайта в системе «PayOnline». | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="privateSecurityKey" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 3 | ||
+ | | Сопоставление кодов валют из ПК «Мастер-Тур» с кодом валюты в системе «PayOnline». | ||
+ | | В качестве параметра '''key''' указывается '''код валюты''' из ПК «Мастер-Тур», в качестве параметра '''value''' задается '''код валюты''' в системе «PayOnline», например:<br /> | ||
+ | |<syntaxhighlight lang="xml"> | ||
+ | <add key="рб" value="RUB"/> | ||
+ | <add key="$" value="USD"/> | ||
+ | <add key="EU" value="EUR"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 4 | ||
+ | | Настройка, определяющая '''код валюты''', в которой будет '''совершаться платеж''' через платежную систему «PayOnline» при '''значении DefinedBySettings настройки currencyToPay'''. | ||
+ | | '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="currency" value="рб" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 5 | ||
+ | | Настройка, определяющая '''валюту''', в которой будет '''совершаться платеж''' через систему «PayOnline». | ||
+ | Обязательная настройка. | ||
+ | | | ||
+ | * '''Contract''' - оплата в ''валюте путевки''; | ||
+ | * '''Tour''' - оплата в ''валюте тура'';<br /> | ||
+ | * '''National''' – оплата в ''национальной валюте'';<br /> | ||
+ | * '''DefinedBySettings''' - оплата в ''валюте'', ''определенной настройкой'' '''Сurrency'''. | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="currencyToPay" value="Contract" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 6 | ||
+ | | Настройка, определяющая '''тип операции при проведении платежа'''. | ||
+ | Обязательная настройка. | ||
+ | | '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="kindOfPay" value="6" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 7 | ||
+ | | Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''. | ||
+ | Обязательная настройка. | ||
+ | | '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="masterTourUser" value="80" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 8 | ||
+ | | Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''. | ||
+ | Обязательная настройка. | ||
+ | | '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="paymentFilialKey" value="1" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 9 | ||
+ | | Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''. | ||
+ | Обязательная настройка. | ||
+ | | '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="departmentKey" value="2" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 10 | ||
+ | | Настройка, определяющая тип операции при проведении платежа | ||
+ | | '''Ключ операции''' из таблицы '''[PaymentOperations]''' | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="paymentOperationId" value="1"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 11 | ||
+ | | Настройка, определяющая '''тип операции при проведении платежа для комиссий'''. | ||
+ | | '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="paymentOperationCommissionId" value="6" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 12 | ||
+ | | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств'''). | ||
+ | Обязательная настройка. | ||
+ | | '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой). | ||
+ | Комиссия указывается '''в процентах'''.<br /> | ||
+ | Сумма оплаты вычисляется следующим образом:<br /> | ||
+ | Если из ''конечной суммы'' платежа в системе «PayOnline» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br /> | ||
+ | Пример:<br /> | ||
+ | Стоимость путевки - '''100 у.е.''' <br /> | ||
+ | В настройке указана комиссия - '''50%'''.<br /> | ||
+ | Итоговая сумма платежа в системе «PayOnline» - '''200 у.е.'''<br /> | ||
+ | <code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки''). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="addAgencyComission" value="3,627" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 13 | ||
+ | | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц'''). | ||
+ | Обязательная настройка. | ||
+ | | '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой). | ||
+ | Комиссия указывается '''в процентах'''.<br /> | ||
+ | Сумма оплаты вычисляется следующим образом:<br /> | ||
+ | Если из ''конечной суммы'' платежа в системе «PayOnline» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br /> | ||
+ | Пример:<br /> | ||
+ | Стоимость путевки - '''100 у.е.''' <br /> | ||
+ | В настройке указана комиссия - '''50%'''.<br /> | ||
+ | Итоговая сумма платежа в системе «PayOnline» - '''200 у.е.'''<br /> | ||
+ | <code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки''). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="addPersonalComission" value="5" /> | ||
+ | </syntaxhighlight> | ||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 14 | ||
+ | | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''. | ||
+ | | Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="NewDogovorServiceServiceListKey" value="450" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 15 | ||
+ | | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''. | ||
+ | | Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="NewDogovorServiceSvKey" value="1055" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 16 | ||
+ | | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''. | ||
+ | | Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="NewDogovorServicePartnerKey" value="12921" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | | 17 | ||
+ | | Настройка, включающая расчет через Мастер Финанс. | ||
+ | | | ||
+ | * '''false''' - расчет через Мастер Финанс не включен; | ||
+ | * '''true''' - расчет через Мастер Финанс включен. | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="AddPaymentsToMasterFinance" value="false"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |} | ||
+ | <br /> | ||
+ | |||
+ | |||
+ | |||
+ | ==Сценарии работы== | ||
+ | Предполагаются 3 сценария работы:<br /> | ||
+ | 1. Заданы размеры комиссий и параметры '''paymentOperationId''', '''paymentOperationComissionId''', '''NewDogovorServiceSvKey''', '''NewDogovorServiceServiceListKey''', '''NewDogovorServicePartnerKey'''. В этом случае при оплате в базе данных формируется 1 ПКО (сумма за путевку + сумма комиссии), в путевке создается услуга "Комиссия при оплате через платежный шлюз" и сумма путевки увеличивается на размер стоимости созданной услуги.<br /> | ||
+ | 2. Заданы размеры комиссий и параметры '''paymentOperationId''', '''paymentOperationComissionId'''. Параметры '''NewDogovorServiceSvKey''', '''NewDogovorServiceServiceListKey''', '''NewDogovorServicePartnerKey''' не заданы. В этом случае при оплате в базе данных формируются 2 ПКО (отдельно за путевку и за комиссию). Услуга в путевке не создается и сумма путевки не меняется.<br /> | ||
+ | 3. Заданы размеры комиссий и параметр '''paymentOperationId'''. Значение параметра '''paymentOperationComissionId=0''' или параметр отсутствует. Оплата за комиссию уходит сразу в банк. В этом случае при оплате в базе данных формируется 1 ПКО за путевку.<br /> | ||
+ | <span style="color:red">Внимание!</span> Данные настройки не работают при включенной настройке <add key="AddPaymentsToMasterFinance" value="true"/>. | ||
+ | |||
+ | ==Настройка индивидуальных подписей и ссылок для кнопки оплаты== | ||
+ | Имеется возможность добавить индивидуальную подпись и ссылку к баннеру платежной системы. | ||
+ | Необходимо добавить новые параметры в секции '''paymentMethods''' соответствующего способа оплаты: | ||
+ | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add code="17" name="Оплатить с кешбек" logoLink="~/Content/themes/base/images/payCashback.jpg" | ||
+ | header="Оплата тура для участников программы «Кешбэк по карте МИР»" | ||
+ | returnMoneyText = "В последствии можно будет вернуть часть средств" | ||
+ | paymentTermsText = "Условия оплаты туров по программе «Кешбэк по карте МИР»" | ||
paymentTermsLink = "https://payment.webpay.by/" | paymentTermsLink = "https://payment.webpay.by/" | ||
pair = "1" | pair = "1" | ||
Строка 1685: | Строка 2284: | ||
После нажатия кнопки «Оплатить» определяются параметры для выбранной платежной системы (из соответствующей секции описанной в web.config) и формируется ссылка для передачи параметров платежа платежной системе. Затем осуществляется переход по сформированной ссылке.<br /> | После нажатия кнопки «Оплатить» определяются параметры для выбранной платежной системы (из соответствующей секции описанной в web.config) и формируется ссылка для передачи параметров платежа платежной системе. Затем осуществляется переход по сформированной ссылке.<br /> | ||
− | [[Файл: | + | [[Файл:Ag 111.png|x1000px|Оплата]]<br /> |
− | + | ||
+ | ===Возможные ошибки и методы их устранения=== | ||
+ | ====Ошибка SecureChannelFailure==== | ||
+ | Появление такой ошибки может быть вызвано невозможностью установить TLS соединение, которое используется для передачи данных от платежной системы. Вызвано некорректными настройками брандмауэра/firewall или некорректными настройками сервера. В случае обнаружения закрытого канала TLS необходимо обратиться к администратору вашей интернет-сети. | ||
+ | On error occurred during signing in. Contact our manager System.Exception: Some error occured: SecureChannelFailure at Megatec.MasterWeb.PaymentSystem.Tinkoff.TinkoffGateway.Authorization(TinkoffParameters parameters, String token) in C:\Users\vmizh\Work\MasterTour\Source\MW\Megatec.MasterWeb.PaymentSystem.Tinkoff\TinkoffGateway.cs:line 430 at Megatec.MasterWeb.PaymentSystem.Tinkoff.TinkoffGateway.Login(IPaymentParameters parameters) in C:\Users\vmizh\Work\MasterTour\Source\MW\Megatec.MasterWeb.PaymentSystem.Tinkoff\TinkoffGateway.cs:line 106 at MasterWebStandard2.Payment.ParseRequest(String action, String orderCode) | ||
+ | |||
+ | <font style="color:red">''Для проверки доступности TLS соединения необходимо выполнить следующую команду в командной строке или в оболочке Powershell, заменив ссылку на ссылку для необходимой системы оплаты:''</font><br /> | ||
+ | '''Invoke-WebRequest -Uri https://securepay.tinkoff.ru'''<br /> | ||
+ | |||
+ | Вариант успешного ответа при доступном соединении<br /> | ||
+ | Invoke-WebRequest : Удаленный сервер возвратил ошибку: (404) Не найден. | ||
+ | строка:1 знак:1 | ||
+ | + Invoke-WebRequest -Uri https://securepay.tinkoff.ru | ||
+ | |||
+ | Вариант некорректного ответа при закрытом соединении<br /> | ||
+ | Invoke-WebRequest : The request was aborted: Could not create SSL/TLS secure channel. | ||
+ | At line:1 char:2 | ||
+ | + Invoke-WebRequest -Uri https://securepay.tinkoff.ru | ||
+ | |||
+ | ====Ошибка конфигурации==== | ||
+ | [[Файл: ea_297.png]]<br /> | ||
+ | <font style="color:red">''Проверить наличие символов на строке 67 и в строках ниже файла web.config.''</font><br /> | ||
+ | |||
+ | ====500 Внутренняя ошибка сервера==== | ||
+ | [[Файл: ea_298.png]]<br /> | ||
+ | <font style="color:red">''Проверить, что не пропущен символ кавычки " в параметрах файла web.config.''</font><br /> | ||
+ | ====Извините, при обработке запроса произошла ошибка.==== | ||
+ | [[Файл: ea_299.png]]<br /> | ||
+ | <font style="color:red">''Проверить, что не допущено ошибок в параметрах секции конкретной платежной системы, по которой происходит оплата, в файле web.config.''</font><br /> | ||
[[Category:Платежные_web-сервисы]] | [[Category:Платежные_web-сервисы]] |
Текущая версия на 19:35, 2 октября 2024
Содержание
- 1 Введение
- 2 Установка
- 3 Настройка
- 3.1 Подключение к базе данных ПК «Мастер-Тур»
- 3.2 Настройки в файле web.config ПК «Мастер-Web»
- 3.3 Настройки в секции appSettings модуля EntryPoint
- 3.4 Настройки в секции paymentMethods модуля EntryPoint
- 3.5 Настройки в секции paymentAvailabilities модуля EntryPoint
- 3.6 Настройки подключения и параметров используемых платежных систем модуля EntryPoint
- 4 Сценарии работы
- 5 Настройка индивидуальных подписей и ссылок для кнопки оплаты
- 6 Настройка стилей
- 7 Подготовка данных
- 8 Работа в системе
Введение
Перед началом работы с платежными системами необходимо удостовериться в соответствии оборудования и программного обеспечения системно-аппаратным требованиям. Если версия операционной системы не соответствует рекомендуемой, то работа с платежными сервисами не гарантирована в связи с ограничениями протоколов безопасности операционной системы.
Модуль EntryPoint предоставляет возможность покупателю/агентству выбрать способ оплаты путевок. Оплата путевок может осуществляться в экранах «Список заявок» (OrderList.aspx) и «Путевка» (OrderInfo.aspx).
В данный момент доступны следующие способы оплаты:
- Alfabank
- Sberbank
- Tinkoff (Т-Банк)
- Uniteller
- YandexPay
- Assist
- WebPay
- PayOnline
Установка
Для установки дополнительного модуля EntryPoint нужно создать директорию EntryPoint в каталоге C:/inetpub/wwwroot
(корневом каталоге IIS) и выложить туда распакованные файлы из архива
mw-paymentSystem-entryPoin-15.8.0.xxxxxx.zip
.
В управлении IIS необходимо создать виртуальный каталог для папки EntryPoint.
Создание виртуального каталога
По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot
. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:
1 Зайти в Пуск (Start) → Настройки (Settings) → Панель управления (Control Panel) → Администрирование (Administrative Tools)
2 Диспетчер служб IIS
3 В открывшемся дереве каталогов выбрать Web Sites – Default Web Site. В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и выбрать Преобразовать в приложение
4 В открывшемся окне нужно нажать кнопку ОК
Настройка
Подключение к базе данных ПК «Мастер-Тур»
В файле web.config
, расположенном в папке EntryPoint пропишите необходимые параметры подключения (красным цветом выделены значения, которые необходимо ввести).
Строка подключения к базе данных ПК «Мастер-Тур»:
<add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК «Мастер-Тур»;Initial Catalog=название базы данных ПК «Мастер-Тур»;User ID=логин пользователя ПК «Мастер-Тур»;Password=пароль пользователя ПК «Мастер-Тур»"/>
Настройки в файле web.config ПК «Мастер-Web»
Для включения возможности работы EntryPoint необходимо настроить файл конфигурации ПК «Мастер-Web». Настройки задаются в секции <appSettings>
файла web.config
основного приложения ПК «Мастер-Web».
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Включение дополнительного модуля EntryPoint.
Обязательная настройка. |
- true - модуль EntryPoint включен
- false или отсутствие настройки - модуль EntryPoint выключен |
<add key="usePaymentEntryPoint" value="true"/>
|
2 | Включение дополнительного модуля EntryPoint.
Обязательная настройка. |
- Путь к приложению «EntryPoint». | <add key="paymentsLink" value="http://somesite/EntryPoint" />
|
3 | Настройка, определяющая статусы путевок, при которых доступна возможность оплаты через систему электронных платежей.
Обязательная настройка. |
- ключи статусов из таблицы [Order_Status] , при которых доступна оплата через систему электронных платежей.
|
<add key="paymentsStatuses" value="7,37" />
|
4 | Настройка, позволяющая выводить предупреждающее сообщение о снятии комиссии при оплате. | – true — сообщение отображается;
– false или отсутствие настройки — сообщение не отображается. |
<add key="askUserBeforePayment" value="true" />
|
5 | Настройка, определяющая дату, на которую будет подбираться курс валют для пересчета суммы к оплате. |
|
<add key="courseExchangeDate" value="OrderDate" />
|
6 | Настройка, определяющая партнеров в базе ПК «Мастер-Тур», которым разрешено осуществлять оплату путёвок онлайн. |
|
<add key="allowedPaymentPartnerKeys" value="10764"/>
|
7 | Включение режима записи нового платежа в систему «Мастер-Финанс». При этом в ПК «Мастер-Тур» платежи не сохраняются. |
|
<add key="AddPaymentsToMasterFinance" value="true" />
|
8 | Настройка, позволяющая производить оплату в новой вкладке браузера. |
|
<add key="OpenPaymentInNewWindow" value="true" />
|
Настройки в секции appSettings модуля EntryPoint
Настройки секции <appSettings>
файла web.config
модуля EntryPoint.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Строка подключения к базе данных ПК «Мастер-Тур» |
<add key="connectionString" value="Data Source=SERVER;Initial Catalog=DATABASE;User Id=AllServices;Password=1"/>
| |
2 | Строка подключения к сервису MTS | <add key="acceptableServices" value="MTS"/>
| |
3 | Настройка, включающая механизм хэширования пароля пользователя, сохраняемого в файлах cookie, что позволяет усилить безопасность ПК "Мастер-Web". По умолчанию хэширование включено. Значение настройки должно совпадать со значением в файле web.config ПК "Мастер-Web". | false - хэширование пароля в файлах cookie выключено;
true или отсутствие настройки - хэширование пароля в файлах cookie включено. |
<add key="HashPasswordForCookie" value="true" />
|
4 | Настройка интервала опроса платежной системы для проверки статуса незавершенных платежей. |
Интервал опроса платежной системы в минутах для проверки статуса незавершенных платежей. При отсутствии настройки или указании значения меньше 3 опрос осуществляется раз в 3 минуты. Опрос осуществляется через указанное количество минут до времени указанного в настройке "TimeInMinuteForCheckStatePayments" |
<add key ="TimeoutInMinuteForPollPaymentSystem" value="3"/>
|
5 | Настройка задержки проверки статуса платежа на платежной системе. |
Отсрочка проверки статуса платежа с момента перехода на платежный шлюз, если платеж сразу не прошел в системе банка. Если по истечении этого времени статус платежа на стороне банка не станет оплаченным, то платеж в ПК "Мастер-Тур" не отобразится. При отсутствии настройки или указании значения меньше 10 отсрочка составляет 10 минут. |
<add key ="TimeInMinuteForCheckStatePayments" value="10"/>
|
6 | Текст правил оплаты |
Правила оплаты берутся из файла AgreementText.htm Если данный файл отсутствует, то описание правил оплаты берется из стандартного файла AgreementText_Standard.htm |
<add key="agreementText" value="templates/AgreementText.htm" />
|
Настройки в секции paymentMethods модуля EntryPoint
В данной секции происходит настройка описания способов оплаты в платежных системах.
Настройки секции <paymentMethods>
файла web.config
модуля EntryPoint.
<paymentMethods> <add code="1" name="Tinkoff" logoLink="~/Content/logos/logoTinkoff.png" maximumAmount="1000000" skipDescriptionPage="false" paymentSystem="Tinkoff" link="https://securepay.tinkoff.ru/v2/Init/" /> </paymentMethods>
- code="1" - идентификатор платежного метода, должен быть уникальным. Используется в других секциях, для ссылки на данный метод оплаты;
- name="Tinkoff" - название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
- paymentSystem="Tinkoff" - название платежной системы. Одно из предопределенных значений:
- Alfabank
- Sberbank и SberbankMir, SberbankChildren
- Tinkoff
- Uniteller и UnitellerMir, UnitellerChildren
- Assist
- WebPay
- PayOnline
- LogoLink - расположение логотипа способа оплаты;
- maximumAmount - максимальный размер платежа;
- skipDescriptionPage - отображать экран редактирования оплаты или сразу выполнять платеж с текущими значениями.
Если значение skipDescriptionPage=true, то сразу происходит переход к оплате.
Если значение skipDescriptionPage=false, то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.
- link - ссылка на платежную систему, по которой доступен данный способ оплаты.
Настройки в секции paymentAvailabilities модуля EntryPoint
В данной секции происходит настройка описания доступных способов оплаты, заданных в секции paymentMethods, текущему пользователю.
<paymentAvailabilities> <add code="1" paymentMethodCode="1" countryCode="7" filialCode="1" consumerCode="Person" isAvailable="false" priority="100" tourTypes="2"/> </paymentAvailabilities>
- code - идентификатор доступности способа оплаты, должен быть уникальным;
- paymentMethodCode - идентификатор способа оплаты (code) из секции paymentMethod;
- countryCode - ограничение доступности метода оплаты по ключу страны (cn_key из таблицы tbl_country). Может быть пустым - доступен для всех стран;
- filialCode - ограничение доступности метода оплаты по коду партнера-филиала из его карточки (поле PR_COD). Может быть пустым - доступен для всех филиалов;
- consumerCode - ограничение по типу забронировавшего: турист или агентство. Person - для частных лиц, Agency - для турагентств;
- isAvailable - включено или выключено это ограничение. Значение false равносильно отсутствию строки в секции;
- priority - приоритет при выборе нескольких доступных вариантов оплаты;
- tourTypes - ограничение доступности метода оплаты по ключу типа тура (tp_key из таблицы TipTur). Отсутствие параметра или пустой параметр - оплата доступна для всех типов туров.
Настройки подключения и параметров используемых платежных систем модуля EntryPoint
Настройка подключения и параметров используемых платежных систем производится в конкретной секции платежной системы.
Alfabank
Настройки задаются в секции <Alfabank>
файла web.config
приложения EntryPoint.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Точки продажи (shop_ID)
Обязательная настройка. |
Shop_ID из раздела Точки продажи ЛК «Alfabank». | <add key="shop_id" value="32565" />
|
2 | Логин
Обязательная настройка. |
Login из раздела Параметры авторизации ЛК «Alfabank». | <add key="login" value="megatec" />
|
3 | Пароль
Обязательная настройка. |
Password из раздела Параметры авторизации ЛК «Alfabank». | <add key="password" value="ХХХХХХХХХХ" />
|
4 | Настройка, определяющая язык окна платежной формы «Alfabank».
Обязательная настройка. |
|
<add key="language" value="ru" />
|
5 | Ссылка на платежный шлюз |
Ссылка на платежный шлюз |
<add key="paymentSystemLoginURL" value="https://ws.egopay.ru/order/v2/" />
|
6 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) |
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. |
<add key="addAgencyComission" value="15,8" />
|
7 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) |
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. |
<add key="addPersonalComission" value="17,4" />
|
8 | Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.
Обязательная настройка. |
Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList] ).
|
<add key="masterTourUser" value="0" />
|
9 | Настройка, определяющая отдел, к которому будет привязываться оплата.
Обязательная настройка. |
Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps] ).
|
<add key="departmentKey" value="0" />
|
10 | Настройка, включающая расчет через Мастер финанс. |
|
<add key="AddPaymentsToMasterFinance" value="false"/>
|
11 | Настройка, определяющая тип операции при проведении платежа.
Обязательная настройка. |
Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="PaymentOperationId" value="6" />
|
12 | Настройка, определяющая тип операции при проведении платежа для комиссий. | Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="paymentOperationCommissionId" value="" />
|
13 | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. | Ключ услуги (Поле SL_KEY из таблицы [ServiceList] ).
Название услуги комиссии в путевке берется из этого параметра |
<add key="NewDogovorServiceServiceListKey" value="450" />
|
14 | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. | Ключ класса услуги (Поле SV_KEY из таблицы [Service] ).
Название услуги комиссии в путевке берется из этого параметра |
<add key="NewDogovorServiceSvKey" value="1055" />
|
15 | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. | Ключ класса услуги (Поле PR_KEY из таблицы [Partners] ).
|
<add key="NewDogovorServicePartnerKey" value="12921" />
|
16 | Настройка, определяющая адрес электронной почты по умолчанию. | Используется в том случае, если не указан адрес электронной почты главного туриста. | <add key="defaultEmail" value="" />
|
Формирование чеков Alfabank
Настройки для формирования чека задаются в секции <Alfabank>
файла web.config
приложения EntryPoint.
Обратите внимание, настройки являются обязательными.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Система налогообложения | Значения:
general — общая simple_income — упрощенная (доходы) simple_profit — упрощенная (доходы минус расходы) patent — патентная unified_agricultural — единый сельскохозяйственный налог |
<add key="TaxationCode" value="general" />
|
2 | Ставка НДС | Значения:
no — без НДС 0 — 0% 10 — 10% 20 — 20% 10/110 — 10/110 20/120 — 20/120 |
<add key="Tax" value="no" />
|
Обратите внимание, что для каждой услуги отправляется на уровне кода:
- typename - ServiceType согласно ключу SvKey, нигде в чеке не фигурирует;
- number - ключ услуги в БД;
- quantity - 1(услуга);
- name - "Туристическая услуга по путевке {код договора}";
- amount - сумма оплаты по услуге и валюта;
- taxation_item_settlement_method - "full_prepayment";
- taxation_item_type - "service";
- taxation_system - "general" по умолчанию, если не указано иное в конфиге;
- taxes - налог, где
- amount - вычисляется согласно выбранной системе расчета налога и валюта;
- percentage - "no" по умолчанию, иначе - из конфига "20/120" и т.д.;
- type - "vat";
- source - "shop"
- amount - вычисляется согласно выбранной системе расчета налога и валюта;
Обратите внимание, что для корректной записи платежей в Мастер Тур, необходимо настроить автоматическое подтверждение платежа. Для этого необходимо обратиться в техподдержку Альфа-Банка.
Существует возможность также подтверждать платежи вручную. Подробнее можно ознакомиться тут https://ecom.alfabank.ru/assets/instructions/merchantManual/pages/index/general_description.html#koordinati_podkljuchenija или запросить информацию в технической поддержке Альфа-Банка
Sberbank
Настройки задаются в секции <Sberbank>
файла web.config
приложения EntryPoint. При использовании SberbankMir или SberbankMir необходимо заполнить соответствующие секции в файле web.config
.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Идентификатор клиента, который выдается платежной системой Sberbank.
Обязательная настройка. |
Идентификатор клиента | <add key="userName" value="логин sberbank-api" />
|
2 | Пароль клиента, который выдается платежной системой Sberbank.
Обязательная настройка. |
Пароль клиента | <add key="password" value="пароль sberbank-api" />
|
3 | Ссылка на платежный шлюз Sberbank | Аналогично настройке link в секции Sberbank в разделе<paymentMethods> | <add key="sberbankPaymentApplicationUrl" value="https://securepayments.sberbank.ru/payment/rest/" />
|
4 | Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.
Обязательная настройка. |
Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList] ).
|
<add key="masterTourUser" value="95" />
|
5 | Настройка, позволяющая создавать объект orderBundle (товарная корзина), в котором передаются все необходимые данные о товаре/услуге. |
По умолчанию настройка имеет значение false. |
<add key="useFiscalization" value="false"/>
|
6 | Настройка, определяющая тип операции при проведении платежа.
Обязательная настройка. |
Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="PaymentOperationId" value="1" />
|
7 | Настройка, определяющая тип операции при проведении платежа для комиссий. | Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="paymentOperationCommissionId" value="6" />
|
8 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств). |
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется либо запятой, либо точкой).
Комиссия указывается в процентах. |
<add key="addAgencyComission" value="3.627" />
|
9 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц). |
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется либо запятой, либо точкой).
Комиссия указывается в процентах. |
<add key="addPersonalComission" value="5.0" />
|
10 | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. | Ключ услуги (Поле SL_KEY из таблицы [ServiceList] ).
|
<add key="NewDogovorServiceServiceListKey" value="450" />
|
11 | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. | Ключ класса услуги (Поле SV_KEY из таблицы [Service] ).
|
<add key="NewDogovorServiceSvKey" value="1055" />
|
12 | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. | Ключ класса услуги (Поле PR_KEY из таблицы [Partners] ).
|
<add key="NewDogovorServicePartnerKey" value="12921" />
|
13 | Настройка, включающая расчет через Мастер финанс. |
|
<add key="AddPaymentsToMasterFinance" value="false"/>
|
Tinkoff (Т-Банк)
Настройки задаются в секции <paymentMethods>
файла web.config
приложения EntryPoint.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Платежный метод
Обязательная настройка. |
способ оплаты в платежной системе «Tinkoff (Т-Банк)».
|
<add code="12" name="Платформа Tinkoff" logoLink="~/Content/logos/logoTinkoff.png"
maximumAmount="1000000"
skipDescriptionPage="false" displayWindowWithEditingRequestData="true" paymentSystem="Tinkoff" />
|
Настройки задаются в секции <Tinkoff>
файла web.config
приложения EntryPoint.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Адрес платежной службы
Обязательная настройка. |
Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)». | <add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
|
2 | Адрес для оплаты по QR коду
Обязательная настройка. |
Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)» по QR коду. | <add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
|
3 | Адрес метода для получения статуса платежа
Обязательная настройка. |
Адрес метода для получения статуса платежа. | <add key="GetStateUrl" value="https://securepay.tinkoff.ru/v2/GetState"/>
|
4 | Адрес метода возвращающего статус заказа
Обязательная настройка. |
Адрес метода возвращающего статус заказа. | <add key="CheckOrderUrl" value="https://securepay.tinkoff.ru/v2/CheckOrder"/>
|
5 | Идентификатор терминала
Обязательная настройка. |
Параметр Терминал из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)». | <add key="TerminalKey" value="1587990738"/>
|
6 | Пароль терминала
Обязательная настройка. |
Параметр Пароль из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)». | <add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
|
7 | Настройка, определяющая язык окна платежной формы «Tinkoff (Т-Банк)».
Обязательная настройка. |
|
<add key="LanguageFormCode" value="ru"/>
|
8 | Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей. |
|
<add key="TaxationCode" value="osn"/>
|
9 | Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей. |
|
<add key="Tax" value="none"/>
|
10 | Настройка, определяющая тип операции при проведении платежа.
Обязательная настройка. |
Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="PaymentOperationId" value="6" />
|
11 | Настройка, определяющая тип операции при проведении платежа для комиссий. | Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="paymentOperationCommissionId" value="" />
|
12 | Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.
Обязательная настройка. |
Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList] ).
|
<add key="masterTourUser" value="80" />
|
13 | Настройка, определяющая партнера, к которому будет привязываться оплата.
Обязательная настройка. |
Ключ филиала, к которому привязывается оплата (Поле PR_KEY из таблицы [Partners] ).
|
<add key="paymentFilialKey" value="1" />
|
14 | Настройка, определяющая отдел, к которому будет привязываться оплата.
Обязательная настройка. |
Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps] ).
|
<add key="departmentKey" value="2" />
|
15 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) |
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. |
<add key="addAgencyComission" value="15,8" />
|
16 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) |
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. |
<add key="addPersonalComission" value="17,4" />
|
17 | Настройка, включающая расчет через Мастер финанс. |
|
<add key="AddPaymentsToMasterFinance" value="false"/>
|
18 | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. | Ключ услуги (Поле SL_KEY из таблицы [ServiceList] ).
Название услуги комиссии в путевке берется из этого параметра |
<add key="NewDogovorServiceServiceListKey" value="450" />
|
19 | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey.
Название услуги комиссии в путевке берется из этого параметра |
Ключ класса услуги (Поле SV_KEY из таблицы [Service] ).
|
<add key="NewDogovorServiceSvKey" value="1055" />
|
20 | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. | Ключ класса услуги (Поле PR_KEY из таблицы [Partners] ).
|
<add key="NewDogovorServicePartnerKey" value="12921" />
|
21 | Настройки, определяющие способ расчета. Если значение не передано, по умолчанию будет передаваться full_payment – полный расчет.
|
Возможные значения:
|
<add key="PaymentMethodMain" value="prepayment" />
<add key="PaymentMethodPrepayment" value="full_prepayment" />
<add key="PaymentMethodFull" value="" />
|
Uniteller
Настройки задаются в секции <Uniteller>
файла web.config
приложения EntryPoint. При использовании UnitellerMir или UnitellerChildren необходимо заполнить соответствующие секции в файле web.config
.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Точки продажи (shopIDP)
Обязательная настройка. |
Uniteller Point ID из раздела Точки продажи ЛК «Uniteller». | <add key="shopIDP" value="00005432"/>
|
2 | Логин
Обязательная настройка. |
Login из раздела Параметры авторизации ЛК «Uniteller». | <add key="login" value="2281" />
|
3 | Пароль
Обязательная настройка. |
Password из раздела Параметры авторизации ЛК «Uniteller». | <add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
|
4 | Платёжная система кредитной карты. |
|
<add key="meanType" value="" />
|
5 | Тип электронной валюты. |
|
<add key="eMoneyType" value="" />
|
6 | Таймаут между попытками запроса результата |
По умолчанию 100. |
<add key="requestTimeout" value="100" />
|
7 | Количество попыток запроса результата |
По умолчанию 5. |
<add key="requestAttempts" value="5" />
|
8 | Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.
Обязательная настройка. |
Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList] ).
|
<add key="masterTourUser" value="80" />
|
9 | Настройка, определяющая партнера, к которому будет привязываться оплата.
Обязательная настройка. |
Ключ филиала, к которому привязывается оплата (Поле PR_KEY из таблицы [Partners] ).
|
<add key="paymentFilialKey" value="1" />
|
10 | Настройка, определяющая отдел, к которому будет привязываться оплата.
Обязательная настройка. |
Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps] ).
|
<add key="departmentKey" value="2" />
|
11 | Настройка, определяющая валюту, в которой будет совершаться платеж через систему «Uniteller».
Обязательная настройка. |
|
<add key="currencyToPay" value="Contract" />
|
12 | Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему «Uniteller» при значении DefinedBySettings настройки currencyToPay. | Код валюты (Поле RA_CODE из таблицы [Rates] ).
Код валюты из ПК «Мастер-Тур» должен быть сопоставлен с кодом валюты в системе «Uniteller». Данное сопоставление задается в секции <currencyMap>
<add key="рб" value="RUB"/>
<add key="грн" value="UAH"/>
<add key="azn" value="AZN"/>
<add key="тг" value="KZT"/>
</currencyMap>
|
<add key="currency" value="рб" />
|
13 | Включение функционала фискализации платежей. После включения необходимо заполнить настройки Код системы налогообложения (TaxMode) и Код ставки налогообложения (TaxRateCode). |
|
<add key="UseFiscalization" value="true"/>
|
14 | Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей. |
|
<add key="TaxMode" value=""/>
|
15 | Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей. |
|
<add key="TaxRateCode" value=""/>
|
16 | Настройка, задающая услугу страхования, добавляемую в фискальный чек. Применяется в случае если в путевке отсутствует скрытая услуга "Операторский тур".
Описание формирования чека с данными настройками находится в разделе Формирование чека при использовании скрытой услуги "Операторский тур" в путевке. |
Ключ класса услуги (Поле SV_KEY из таблицы [Service] ).
|
<add key="InsuranceServiceKey" value="6"/>
|
17 | Настройка задающая название услуги в фискальном чеке если в путевке имеется скрытая услуга "Операторский тур". Описание формирования чека с данными настройками находится в разделе Формирование чека при использовании скрытой услуги "Операторский тур" в путевке. | Ключ класса услуги (Поле SV_KEY из таблицы [Service] ).
|
<add key="OperatorTourServiceKey" value="1134"/>
|
18 | Настройка, определяющая тип операции при проведении платежа.
Обязательная настройка. |
Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="PaymentOperationId" value="1" />
|
19 | Настройка, определяющая тип операции при проведении платежа для комиссий. | Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="paymentOperationCommissionId" value="6" />
|
20 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств). | Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).
Комиссия указывается в процентах. |
<add key="addAgencyComission" value="3,627" />
|
21 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц). | Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).
Комиссия указывается в процентах. |
<add key="addPersonalComission" value="5" />
|
22 | Настройка, включающая расчет через Мастер финанс. |
|
<add key="AddPaymentsToMasterFinance" value="false"/>
|
23 | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. | Ключ услуги (Поле SL_KEY из таблицы [ServiceList] ).
|
<add key="NewDogovorServiceServiceListKey" value="450" />
|
24 | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. | Ключ класса услуги (Поле SV_KEY из таблицы [Service] ).
|
<add key="NewDogovorServiceSvKey" value="1055" />
|
25 | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. | Ключ класса услуги (Поле PR_KEY из таблицы [Partners] ).
|
<add key="NewDogovorServicePartnerKey" value="12921" />
|
26 | Настройка, задающая форму оплаты на шлюзе Uniteller | "All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП
Если параметр не указан, или пустой или любой набор символов, то по умолчанию All |
<add key="PaymentFormType" value="Card" />
|
27 | Тип отображения комиссии платежной системы в фискальном чеке. |
0 - увеличивает стоимость позиций по чеку на размер (%) комиссию 1 - добавляет в чек комиссию отдельной строкой |
<add key="ComissionShowModeInVoucher" value ="0"/>
|
28 | Наименование позиции в чеке для комиссии для <add key="ComissionShowModeInVoucher" value ="1"/>. |
По умолчанию - "Комиссия платежной системы" | <add key="ComissionTextInVoucher" value ="Юнителлер комиcсия"/>
|
29 | Вид формирования чека |
true - разбить по услугам отдельно, false - одной строкой из ключа VoucherServiceText |
<add key="VoucherShowDetails" value="false"/>
|
30 | Наименование услуги в чеке |
%dogovor% (не обязательно) - для вставки номера договора. |
<add key="VoucherServiceText" value="Туристическая услуга по договору %dogovor%"/>
|
Фискализация в Uniteller
Настройки задаются в секции <<paymentMethods>>
файла web.config
приложения EntryPoint.
В зависимости от типа используемой фискализации прописывается соответствующая настройка.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Настройка, определяющая адрес шлюза оплаты с включенной фискализацией v.1.0. |
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v1/pay"/>
| |
2 | Настройка, определяющая адрес шлюза оплаты с включенной фискализацией v.2.0. |
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v2/pay"/>
|
Добавлены следующие возможности в версии 2.0 от версии 1.0:
- Продажа подарочных карт, начисления бонусов-авансов, фискализация авансов.
- Частичная либо полная оплаты заказа подарочными картами, бонусами либо другими авансами.
- Возврат авансов и покупок, оплаченых частично либо полностью авансами.
- Отнесение авансов в доход.
- Осуществления агентских продаж.
- Настройка механизма «Защита от штрафов» для интерфейсов версии 2.0.
Добавлены следующие сценарии:
- Операция оплаты с использованием платежной формы (версия 2.0).
- Операция оплаты с использованием API (версия 2.0).
- Операция оплаты через ApplePay с использованием API (версия 2.0).
- Операция подтверждения преавторизации (версия 2.0).
- Операция отнесения авансов в доход с помощью API.
- Операция отнесения авансов в доход с помощью ЛК.
- Частичная или полная отмена платежа с фискализацией, выполненного через Uniteller (версия 2.0).
- Частичная или полная отмена платежа с фискализацией, выполненного через Uniteller через ЛК (версия 2.0).
- В сценарии регистрации заказа добавлена возможность регистрации для интерфейса 2.0.
- Добавлены программные интерфейсы для новых сценариев.
- Для интерфейсов версии 2.0 изменен формат фискального чека.
YandexPay
Настройки задаются в секции <YandexPay>
файла web.config
приложения EntryPoint.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Таймаут запроса
Обязательная настройка. |
Время ожидания ответа от сервера в миллисекундах. | <add key="RequestTimeout" value="10" />
|
2 | API-ключ
Обязательная настройка. |
Уникальный ключ API для доступа к сервисам Yandex Pay. | <add key="ApiKey" value="a8412f07-5583-4b3e-abe1-06ad6733ea1d" />
|
3 | URL создания заказа
Обязательная настройка. |
URL для запроса на создание ссылки на оплату заказа. | <add key="CreateOrderUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" />
|
4 | URL получения деталей заказа
Обязательная настройка. |
URL для запроса на получение деталей заказа. | <add key="GetOrderDetailsUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" />
|
5 | Ставка НДС
Обязательная настройка. |
Значение ставки НДС:
|
<add key="Tax" value="1" />
|
6 | Доступные методы оплаты
Опциональная настройка. |
Методы оплаты, доступные на платежной форме Yandex Pay:
|
<add key="AvailablePaymentMethods" value="2" />
|
7 | Сплит при наличии комиссии
Опциональная настройка. |
Указывает, доступен ли сплит, когда есть комиссия:
|
<add key="AvailableSplitMethodWhenCommission" value="false" />
|
8 | Ключ пользователя
Обязательная настройка. |
Ключ пользователя, к которому привязывается оплата. | <add key="masterTourUser" value="106" />
|
9 | Ключ филиала
Обязательная настройка. |
Ключ филиала, к которому привязывается оплата. | <add key="paymentFilialKey" value="7" />
|
10 | Ключ отдела
Обязательная настройка. |
Ключ отдела (кассы), к которому привязывается оплата. | <add key="departmentKey" value="7" />
|
11 | Тип операции при проведении платежа
Обязательная настройка. |
Ключ операции из таблицы PaymentOperations, определяющий тип операции при проведении платежа. | <add key="PaymentOperationId" value="36" />
|
12 | Тип операции для комиссий
Опциональная настройка. |
Ключ операции из таблицы PaymentOperations для комиссий. | <add key="paymentOperationCommissionId" value="7" />
|
13 | Размер комиссии для агентств
Опциональная настройка. |
Размер комиссии для агентств в процентах. | <add key="addAgencyComission" value="10" />
|
14 | Размер комиссии для частных лиц
Опциональная настройка. |
Размер комиссии для частных лиц в процентах. | <add key="addPersonalComission" value="" />
|
15 | Класс услуги для комиссии
Опциональная настройка. |
Класс услуги, добавляемой в путевку при наличии комиссии. | <add key="NewDogovorServiceSvKey" value="1055" />
|
16 | Услуга для комиссии
Опциональная настройка. |
Услуга, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. | <add key="NewDogovorServiceServiceListKey" value="982" />
|
17 | Партнер для комиссии
Опциональная настройка. |
Партнер, являющийся поставщиком для услуги, добавляемой в путевку при наличии комиссии. | <add key="NewDogovorServicePartnerKey" value="10760" />
|
18 | Расчеты через MasterFinance
Опциональная настройка. |
Указывает, проводятся ли платежи через MasterFinance:
|
<add key="AddPaymentsToMasterFinance" value="false" />
|
19 | Система налогообложения
Обязательная настройка. |
Указывает, какая система налогообложения будет использоваться при платежах:
|
<add key="TaxationCode" value="osn" />
|
20 | Идентификатор группы ККТ
Обязательная настройка. |
Идентификатор группы контрольно-кассовой техники. | <add key="ReceiptGroupCode" value="2ca8430a-ff34-421a-b2aa-2071d79eb782" />
|
21 | Логин для авторизации в сервисе формирования чеков
Обязательная настройка. |
Логин для авторизации в сервисе формирования чеков. | <add key="ReceiptLogin" value="7709624788" />
|
22 | Пароль для авторизации в сервисе формирования чеков
Обязательная настройка. |
Пароль для авторизации в сервисе формирования чеков. | <add key="ReceiptPassword" value="79161128982" />
|
23 | URL для авторизации в сервисе формирования чеков
Обязательная настройка. |
URL для авторизации в сервисе формирования чеков. | <add key="ReceiptAuthUrl" value="https://fiscalization.evotor.ru/possystem/v5/getToken" />
|
24 | Почта для отправки чеков по умолчанию
Опциональная настройка. |
Указывается почта, на которую будут приходить чеки, в случае отсутствия их в партнере или представителе партнера | <add key="ReceiptClientDefaultEmail" value="peligrim@mail.ru" />
|
Assist
Настройки задаются в секции <Assist>
файла web.config
приложения EntryPoint.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Ключ интернет-магазина | Ключ магазина, который предоставляет Assist | <add key="shopID" value="326055"/>
|
2 | Логин для авторизации в системе Assist | Логин для авторизации, который предоставляет Assist. Необходимо добавить обе настройки. | <add key="shopLogin" value="login"/>
|
3 | Пароль для авторизации в системе Assist | Пароль для авторизации, который предоставляет Assist | <add key="shopPassword" value="password"/>
|
4 | Логин для авторизации | Логин веб-сервиса, который предоставляет Assist | <add key="webServiceLogin" value=" login "/>
|
5 | Настройка, определяющая пользователя, к которому будет привязываться оплата | Ключ пользователя из таблицы [UserList], к которому привязывается оплата | <add key="masterTourUser" value="100006"/>
|
6 | Настройка, определяющая партнера, к которому будет привязываться оплата | Ключ партнера из таблицы [tbl_Partners], к которому привязывается оплата | <add key="paymentFilialKey" value="1"/>
|
7 | Настройка, определяющая отдел, к которому будет привязываться оплата | Ключ отдела (кассы) из таблицы [PrtDeps], к которому привязывается оплата | <add key="departmentKey" value="2"/>
|
8 | Боевой/тестовый адрес. Откуда получать ответ. | Боевой адрес, который предоставляет Assist
либо белорусский тестовый сервис: |
<add key="assistGetTransaction" value="" />
|
9 | Секретное слово из личного кабинета | Секретное слово, которое указывается в личном кабинете в Assist | <add key="salt" value="" />
|
10 | Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему Assist | Код валюты из таблицы [Rates], в которой будет совершаться платеж | <add key="assistPaymentsRate" value="рб" />
|
11 | Настройка, определяющая тип операции при проведении платежа | Ключ операции из таблицы [PaymentOperations] | <add key="paymentOperationId" value="1"/>
|
12 | Настройка, определяющая тип операции при проведении платежа для комиссий. | Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="paymentOperationCommissionId" value="6" />
|
13 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств). | Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).
Комиссия указывается в процентах. |
<add key="addAgencyComission" value="3,627" />
|
14 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц). | Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).
Комиссия указывается в процентах. |
<add key="addPersonalComission" value="5" />
|
15 | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. | Ключ услуги (Поле SL_KEY из таблицы [ServiceList] ).
|
<add key="NewDogovorServiceServiceListKey" value="450" />
|
16 | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. | Ключ класса услуги (Поле SV_KEY из таблицы [Service] ).
|
<add key="NewDogovorServiceSvKey" value="1055" />
|
17 | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. | Ключ класса услуги (Поле PR_KEY из таблицы [Partners] ).
|
<add key="NewDogovorServicePartnerKey" value="12921" />
|
18 | Настройка, включающая расчет через Мастер Финанс. |
|
<add key="AddPaymentsToMasterFinance" value="false"/>
|
Webpay
Настройки задаются в секции <Webpay>
файла web.config
приложения EntryPoint.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Идентификатор клиента в платежной системе | предоставляется Webpay | <add key="storeID" value="344612596"/>
|
2 | Пароль клиента в платежной системе | предоставляется Webpay | <add key="privateKey" value="37kfffkvjj"
|
3 | Код платежного агента | предоставляется Webpay | <add key="customerID" value="megatec-2" />
|
4 | Настройка, определяющая пользователя, к которому будет привязываться оплата | Ключ пользователя из таблицы [UserList], к которому привязывается оплата | <add key="masterTourUser" value="100006"/>
|
5 | Настройка, определяющая партнера, к которому будет привязываться оплата | Ключ партнера из таблицы [tbl_Partners], к которому привязывается оплата | <add key="paymentFilialKey" value="1"/>
|
6 | Настройка, определяющая отдел, к которому будет привязываться оплата | Ключ отдела (кассы) из таблицы [PrtDeps], к которому привязывается оплата | <add key="departmentKey" value="2"/>
|
7 | Откуда получать ответ. Тестовый адрес: https://sandbox.webpay.by | адрес платежного сервиса | <add key="webPayGetTransaction" value="https://securesandbox.webpay.by" />
|
8 | Режим тестирования | Режим тестирования - 1, боевой режим - 0 | <add key="isTest" value="1" />
|
9 | Настройка, определяющая тип операции при проведении платежа | Ключ операции из таблицы [PaymentOperations] | <add key="paymentOperationId" value="1"/>
|
10 | Настройка, определяющая тип операции при проведении платежа для комиссий. | Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="paymentOperationCommissionId" value="6" />
|
11 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств). | Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).
Комиссия указывается в процентах. |
<add key="addAgencyComission" value="3,627" />
|
12 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц). | Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).
Комиссия указывается в процентах. |
<add key="addPersonalComission" value="5" />
|
13 | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. | Ключ услуги (Поле SL_KEY из таблицы [ServiceList] ).
|
<add key="NewDogovorServiceServiceListKey" value="450" />
|
14 | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. | Ключ класса услуги (Поле SV_KEY из таблицы [Service] ).
|
<add key="NewDogovorServiceSvKey" value="1055" />
|
15 | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. | Ключ класса услуги (Поле PR_KEY из таблицы [Partners] ).
|
<add key="NewDogovorServicePartnerKey" value="12921" />
|
16 | Настройка, включающая расчет через Мастер Финанс. |
|
<add key="AddPaymentsToMasterFinance" value="false"/>
|
PayOnline
Настройки задаются в секции <PayOnline>
файла web.config
приложения EntryPoint.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Ключ сайта.
Обязательная настройка. |
Merchant ID сайта в системе «PayOnline». | <add key="merchantId" value="2898" />
|
2 | Ключ.
Обязательная настройка. |
Security key в Параметрах интеграции сайта в системе «PayOnline». | <add key="privateSecurityKey" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
|
3 | Сопоставление кодов валют из ПК «Мастер-Тур» с кодом валюты в системе «PayOnline». | В качестве параметра key указывается код валюты из ПК «Мастер-Тур», в качестве параметра value задается код валюты в системе «PayOnline», например: |
<add key="рб" value="RUB"/>
<add key="$" value="USD"/>
<add key="EU" value="EUR"/>
|
4 | Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему «PayOnline» при значении DefinedBySettings настройки currencyToPay. | Код валюты (Поле RA_CODE из таблицы [Rates] ).
|
<add key="currency" value="рб" />
|
5 | Настройка, определяющая валюту, в которой будет совершаться платеж через систему «PayOnline».
Обязательная настройка. |
|
<add key="currencyToPay" value="Contract" />
|
6 | Настройка, определяющая тип операции при проведении платежа.
Обязательная настройка. |
Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="kindOfPay" value="6" />
|
7 | Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.
Обязательная настройка. |
Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList] ).
|
<add key="masterTourUser" value="80" />
|
8 | Настройка, определяющая партнера, к которому будет привязываться оплата.
Обязательная настройка. |
Ключ филиала, к которому привязывается оплата (Поле PR_KEY из таблицы [Partners] ).
|
<add key="paymentFilialKey" value="1" />
|
9 | Настройка, определяющая отдел, к которому будет привязываться оплата.
Обязательная настройка. |
Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps] ).
|
<add key="departmentKey" value="2" />
|
10 | Настройка, определяющая тип операции при проведении платежа | Ключ операции из таблицы [PaymentOperations] | <add key="paymentOperationId" value="1"/>
|
11 | Настройка, определяющая тип операции при проведении платежа для комиссий. | Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="paymentOperationCommissionId" value="6" />
|
12 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств).
Обязательная настройка. |
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).
Комиссия указывается в процентах. |
<add key="addAgencyComission" value="3,627" />
|
13 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц).
Обязательная настройка. |
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).
Комиссия указывается в процентах. |
<add key="addPersonalComission" value="5" />
|
14 | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. | Ключ услуги (Поле SL_KEY из таблицы [ServiceList] ).
|
<add key="NewDogovorServiceServiceListKey" value="450" />
|
15 | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. | Ключ класса услуги (Поле SV_KEY из таблицы [Service] ).
|
<add key="NewDogovorServiceSvKey" value="1055" />
|
16 | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. | Ключ класса услуги (Поле PR_KEY из таблицы [Partners] ).
|
<add key="NewDogovorServicePartnerKey" value="12921" />
|
17 | Настройка, включающая расчет через Мастер Финанс. |
|
<add key="AddPaymentsToMasterFinance" value="false"/>
|
Сценарии работы
Предполагаются 3 сценария работы:
1. Заданы размеры комиссий и параметры paymentOperationId, paymentOperationComissionId, NewDogovorServiceSvKey, NewDogovorServiceServiceListKey, NewDogovorServicePartnerKey. В этом случае при оплате в базе данных формируется 1 ПКО (сумма за путевку + сумма комиссии), в путевке создается услуга "Комиссия при оплате через платежный шлюз" и сумма путевки увеличивается на размер стоимости созданной услуги.
2. Заданы размеры комиссий и параметры paymentOperationId, paymentOperationComissionId. Параметры NewDogovorServiceSvKey, NewDogovorServiceServiceListKey, NewDogovorServicePartnerKey не заданы. В этом случае при оплате в базе данных формируются 2 ПКО (отдельно за путевку и за комиссию). Услуга в путевке не создается и сумма путевки не меняется.
3. Заданы размеры комиссий и параметр paymentOperationId. Значение параметра paymentOperationComissionId=0 или параметр отсутствует. Оплата за комиссию уходит сразу в банк. В этом случае при оплате в базе данных формируется 1 ПКО за путевку.
Внимание! Данные настройки не работают при включенной настройке <add key="AddPaymentsToMasterFinance" value="true"/>.
Настройка индивидуальных подписей и ссылок для кнопки оплаты
Имеется возможность добавить индивидуальную подпись и ссылку к баннеру платежной системы. Необходимо добавить новые параметры в секции paymentMethods соответствующего способа оплаты:
<add code="17" name="Оплатить с кешбек" logoLink="~/Content/themes/base/images/payCashback.jpg"
header="Оплата тура для участников программы «Кешбэк по карте МИР»"
returnMoneyText = "В последствии можно будет вернуть часть средств"
paymentTermsText = "Условия оплаты туров по программе «Кешбэк по карте МИР»"
paymentTermsLink = "https://payment.webpay.by/"
pair = "1"
maximumAmount="1000000"
skipDescriptionPage="true" paymentSystem="Uniteller" link="https://fpay.uniteller.ru/v2/pay"/>
- header - шапка с основным описанием способа оплаты
- returnMoneyText - дополнительное описание способа оплаты
- paymentTermsText - текст гиперссылки
- paymentTermsLink - ссылка на которую происходит переход при нажатии на текст гиперссылки
- pair - параметр позволяющий связать 2 баннера в пару
В случае, если имеется необходимость в отображении нескольких баннеров с подписями, для корректного отображения на странице рекомендуется их связывать в пары.
Для того, чтобы баннеры отображались рядом необходимо одному присвоить параметр pair = "1", другому - pair = "2" и указать коды данных способов оплат в разделе paymentAvailabilities друг за другом.
Настройка стилей
В папке приложения EntryPoint есть файл Views\Shared\ _Layout.cshtml. В тегах <div> можно разместить информацию в Нeader и Footer. Если Header и Footer не нужны, можно в этом же файле их убрать, удалив теги <div>.
<div id="header"> Header </div> . . . <div id="footer"> Footer </div>
Подготовка данных
Оплату можно произвести по путевкам, статус которых указан в настройке paymentsStatuses.
Перед использованием приложения EntryPoint необходимо в таблице tbl_Country в поле CN_RateKey проставить ключи национальных валют для стран, в которых зарегистрированы филиалы продающие путевки.
Работа в системе
Поиск путевки
Список заявок, забронированных в базе данных туроператора, доступен в экране «Список заказов» по адресу: http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx
.
Экран «Список заказов» доступен только для зарегистрированных и авторизованных в системе пользователей.
После ввода имени пользователя и пароля загрузится список заявок, оформленных на покупателя/агентство, указанного в поле «Партнер в БД МТ» при регистрации пользователя в Системе администрирования ПК «Мастер-Web», который сопоставлен имени текущего пользователя.
Для отбора путевок можно использовать фильтры:
- Поиск по номеру заявки;
- Поиск по фамилии туриста;
- Поиск по статусу документов на визу;
- Поиск по стране;
- Поиск по дате заявки;
- Дата тура с... и Дата тура по...;
- Путевки с наличием услуги «Виза»;
- Путевки с задолженностями.
Способ оплаты
Модуль "Выбор платежной системы" доступен только для путевок имеющих статус, ключ которого указан в настройке paymentsStatuses.
Способ оплаты доступен из в экранов «Список заявок» и «Информация о заказе».
Экран Список заказов доступен по адресу: http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx
.
Экран Информация о заказе доступен по адресу: http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderInfo.aspx
.
Для выбора способа оплаты необходимо нажать ссылку Оплатить для нужной путевки (или кнопку Оплатить on-line в экране Информация о заказе), после чего пользователь попадает в экран, в котором указывается номер заказа и доступные способы оплаты.
Выбрав способ оплаты, открывается экран оплаты, в котором указывается способ оплаты, ссылка на изменение способа (если их несколько), номер путевки, стоимость путевки к оплате, оплаченная сумма, курс валюты, сумма к оплате с учетом комиссии:
Сумму к оплате можно изменить, при этом необходимо учитывать правила оплаты, которые выводятся из файла, путь к которому указан в настройке:
<add key="agreementText" value="templates/AgreementText.htm"/>
При изменении суммы к оплате автоматически высчитывается комиссия.
После нажатия кнопки «Оплатить» определяются параметры для выбранной платежной системы (из соответствующей секции описанной в web.config) и формируется ссылка для передачи параметров платежа платежной системе. Затем осуществляется переход по сформированной ссылке.
Возможные ошибки и методы их устранения
Ошибка SecureChannelFailure
Появление такой ошибки может быть вызвано невозможностью установить TLS соединение, которое используется для передачи данных от платежной системы. Вызвано некорректными настройками брандмауэра/firewall или некорректными настройками сервера. В случае обнаружения закрытого канала TLS необходимо обратиться к администратору вашей интернет-сети.
On error occurred during signing in. Contact our manager System.Exception: Some error occured: SecureChannelFailure at Megatec.MasterWeb.PaymentSystem.Tinkoff.TinkoffGateway.Authorization(TinkoffParameters parameters, String token) in C:\Users\vmizh\Work\MasterTour\Source\MW\Megatec.MasterWeb.PaymentSystem.Tinkoff\TinkoffGateway.cs:line 430 at Megatec.MasterWeb.PaymentSystem.Tinkoff.TinkoffGateway.Login(IPaymentParameters parameters) in C:\Users\vmizh\Work\MasterTour\Source\MW\Megatec.MasterWeb.PaymentSystem.Tinkoff\TinkoffGateway.cs:line 106 at MasterWebStandard2.Payment.ParseRequest(String action, String orderCode)
Для проверки доступности TLS соединения необходимо выполнить следующую команду в командной строке или в оболочке Powershell, заменив ссылку на ссылку для необходимой системы оплаты:
Invoke-WebRequest -Uri https://securepay.tinkoff.ru
Вариант успешного ответа при доступном соединении
Invoke-WebRequest : Удаленный сервер возвратил ошибку: (404) Не найден. строка:1 знак:1 + Invoke-WebRequest -Uri https://securepay.tinkoff.ru
Вариант некорректного ответа при закрытом соединении
Invoke-WebRequest : The request was aborted: Could not create SSL/TLS secure channel. At line:1 char:2 + Invoke-WebRequest -Uri https://securepay.tinkoff.ru
Ошибка конфигурации
Проверить наличие символов на строке 67 и в строках ниже файла web.config.
500 Внутренняя ошибка сервера
Проверить, что не пропущен символ кавычки " в параметрах файла web.config.
Извините, при обработке запроса произошла ошибка.
Проверить, что не допущено ошибок в параметрах секции конкретной платежной системы, по которой происходит оплата, в файле web.config.