Платежные web-сервисы: EntryPoint — различия между версиями
| [непроверенная версия] | [досмотренная версия] |
Aefremov (обсуждение | вклад) (Новая страница: «==Введение== left|Предупреждение <BR> Перед началом работы с платежными система…») |
Gavrilov (обсуждение | вклад) (→Sberbank) |
||
| (не показаны 82 промежуточные версии 4 участников) | |||
| Строка 4: | Строка 4: | ||
Модуль '''EntryPoint''' предоставляет возможность покупателю/агентству выбрать способ оплаты путевок. Оплата путевок может осуществляться в экранах «Список заявок» (OrderList.aspx) и «Путевка» (OrderInfo.aspx). <br /> | Модуль '''EntryPoint''' предоставляет возможность покупателю/агентству выбрать способ оплаты путевок. Оплата путевок может осуществляться в экранах «Список заявок» (OrderList.aspx) и «Путевка» (OrderInfo.aspx). <br /> | ||
В данный момент доступны следующие способы оплаты: | В данный момент доступны следующие способы оплаты: | ||
| − | * | + | * Alfabank |
| − | * | + | * Sberbank |
| − | * | + | * Tinkoff (Т-Банк) |
| − | * | + | * Uniteller |
| − | + | * YandexPay | |
| + | * Assist | ||
| + | * WebPay | ||
| + | * PayOnline | ||
| + | |||
==Установка== | ==Установка== | ||
Для установки дополнительного модуля '''EntryPoint''' нужно создать директорию '''EntryPoint''' в каталоге <code>C:/inetpub/wwwroot</code> (корневом каталоге '''IIS''') и выложить туда распакованные файлы из архива<br /> <code>mw-paymentSystem-entryPoin-15.8.0.xxxxxx.zip</code>. <br /> | Для установки дополнительного модуля '''EntryPoint''' нужно создать директорию '''EntryPoint''' в каталоге <code>C:/inetpub/wwwroot</code> (корневом каталоге '''IIS''') и выложить туда распакованные файлы из архива<br /> <code>mw-paymentSystem-entryPoin-15.8.0.xxxxxx.zip</code>. <br /> | ||
| Строка 27: | Строка 31: | ||
[[Файл: am_748.png|x500px|Добавить приложение]]<br /> | [[Файл: am_748.png|x500px|Добавить приложение]]<br /> | ||
<br /> | <br /> | ||
| + | ==Настройка== | ||
===Подключение к базе данных ПК «Мастер-Тур»=== | ===Подключение к базе данных ПК «Мастер-Тур»=== | ||
В файле <code>web.config</code>, расположенном в папке '''EntryPoint''' пропишите необходимые параметры подключения (<span style="color:red">красным цветом</span> выделены значения, которые необходимо ввести). | В файле <code>web.config</code>, расположенном в папке '''EntryPoint''' пропишите необходимые параметры подключения (<span style="color:red">красным цветом</span> выделены значения, которые необходимо ввести). | ||
| Строка 122: | Строка 127: | ||
| 8 | | 8 | ||
| Настройка, позволяющая производить оплату в новой вкладке браузера.<br> | | Настройка, позволяющая производить оплату в новой вкладке браузера.<br> | ||
| − | |||
| − | |||
| | | | ||
| Строка 135: | Строка 138: | ||
|} | |} | ||
| − | + | ===Настройки логирования=== | |
| + | Настройки секции <code><loggerSection></code> файла <code>web.config</code> модуля EntryPoint. | ||
| + | {| 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 | ||
| + | |Логирование <br> | ||
| + | | | ||
| + | Путь к лог-файлам задается в секции ''Loggers path''. | ||
| + | * ExceptionLogger – информация об ошибках | ||
| + | * MasterWeb – общая информация при работе с системой | ||
| + | * DetailEPLoger – пошаговое отслеживание работы платежной системы (работаем через EP). Сейчас реализован только для Юнителлера, при необходимости можно расширять и на другие платежные системы. Удобно использовать для тестирования и проверки платежной системы на стороне клиента. | ||
| + | | <syntaxhighlight lang="xml" enclose="div"> | ||
| + | <Loggers path="Logs\"> | ||
| + | <Logger level="ALL" name="ExceptionLogger" /> | ||
| + | <Logger level="ALL" name="MasterWeb" /> | ||
| + | <Logger level="OFF" name="DetailEPLoger" /> | ||
| + | </Loggers> | ||
| + | </syntaxhighlight> | ||
| + | |} | ||
| + | ===Настройки в секции appSettings модуля EntryPoint=== | ||
| + | Настройки секции <code><appSettings></code> файла <code>web.config</code> модуля EntryPoint. | ||
{| 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" | ||
| Строка 147: | Строка 179: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
| + | |||
| 1 | | 1 | ||
| − | | | + | |Строка подключения к базе данных ПК «Мастер-Тур» <br> |
| − | + | | | |
| − | + | ||
| − | |<syntaxhighlight lang="xml" enclose="div"> | + | | <syntaxhighlight lang="xml" enclose="div"> |
| − | <add key=" | + | <add key="connectionString" value="Data Source=SERVER;Initial Catalog=DATABASE;User Id=AllServices;Password=1"/> |
</syntaxhighlight> | </syntaxhighlight> | ||
| + | |||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
| 2 | | 2 | ||
| + | | Строка подключения к сервису MTS | ||
| + | | | ||
| + | |||
| + | |<syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="acceptableServices" value="MTS"/> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | | 3 | ||
| Настройка, включающая механизм хэширования пароля пользователя, сохраняемого в файлах cookie, что позволяет усилить безопасность ПК "Мастер-Web". По умолчанию хэширование включено. '''Значение настройки должно совпадать со значением в файле web.config ПК "Мастер-Web"'''. | | Настройка, включающая механизм хэширования пароля пользователя, сохраняемого в файлах cookie, что позволяет усилить безопасность ПК "Мастер-Web". По умолчанию хэширование включено. '''Значение настройки должно совпадать со значением в файле web.config ПК "Мастер-Web"'''. | ||
| − | |'''false''' - хэширование пароля в файлах cookie выключено; '''true''' или '''отсутствие настройки''' - хэширование пароля в файлах cookie включено. | + | |'''false''' - хэширование пароля в файлах cookie выключено; |
| + | '''true''' или '''отсутствие настройки''' - хэширование пароля в файлах cookie включено. | ||
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
<add key="HashPasswordForCookie" value="true" /> | <add key="HashPasswordForCookie" value="true" /> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | |||
| + | | 4 | ||
| + | |Настройка интервала опроса платежной системы для проверки статуса незавершенных платежей. <br> | ||
| + | | | ||
| + | Интервал опроса платежной системы в минутах для проверки статуса незавершенных платежей. | ||
| + | При отсутствии настройки или указании значения меньше 3 опрос осуществляется раз в 3 минуты. | ||
| + | Опрос осуществляется через указанное количество минут до времени указанного в настройке "TimeInMinuteForCheckStatePayments" | ||
| + | | <syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key ="TimeoutInMinuteForPollPaymentSystem" value="3"/> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | | 5 | ||
| + | | Настройка задержки проверки статуса платежа на платежной системе. | ||
| + | | | ||
| + | Отсрочка проверки статуса платежа с момента перехода на платежный шлюз, если платеж сразу не прошел в системе банка. | ||
| + | Если по истечении этого времени статус платежа на стороне банка не станет оплаченным, то платеж в ПК "Мастер-Тур" не отобразится. | ||
| + | При отсутствии настройки или указании значения меньше 10 отсрочка составляет 10 минут. | ||
| + | |<syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key ="TimeInMinuteForCheckStatePayments" value="10"/> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | | 6 | ||
| + | |Текст правил оплаты <br> | ||
| + | | | ||
| + | Правила оплаты берутся из файла AgreementText.htm | ||
| + | Если данный файл отсутствует, то описание правил оплаты берется из стандартного файла AgreementText_Standard.htm | ||
| + | | <syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="agreementText" value="templates/AgreementText.htm" /> | ||
| + | </syntaxhighlight> | ||
| + | |||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
| + | | 7 | ||
| + | | Настройка способа учёта типов тура из <code><paymentAvailabilities></code> (атрибут <code>tourTypes</code>) при определении доступности оплаты. Если <code>value="true"</code>, оплата доступна только когда у тура присутствуют все типы, указанные в <code>tourTypes</code>. Если <code>false</code> или настройка отсутствует – оплата доступна, когда у тура есть хотя бы один тип из <code>tourTypes</code>. | ||
| + | | '''false''' или '''отсутствие настройки''' – оплата доступна при наличии хотя бы одного типа из <code>tourTypes</code>;<br> | ||
| + | '''true''' – оплата доступна только при наличии всех типов из <code>tourTypes</code>. | ||
| + | | <syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="allowPaymentIfAllTypeAllowed" value="true" /> | ||
| + | </syntaxhighlight> | ||
| + | |} | ||
| + | |||
| + | ===Настройки в секции paymentMethods модуля EntryPoint=== | ||
| + | В данной секции происходит настройка описания способов оплаты в платежных системах. | ||
| + | Настройки секции <code><paymentMethods></code> файла <code>web.config</code> модуля 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''' - отображать экран редактирования оплаты или сразу выполнять платеж с текущими значениями.<br /> | ||
| + | Если значение skipDescriptionPage=true, то сразу происходит переход к оплате.<br /> | ||
| + | Если значение skipDescriptionPage=false, то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.<br /> | ||
| + | * '''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''). Отсутствие параметра или пустой параметр – оплата доступна для всех типов туров (допускается внесение нескольких параметров через ","). Если требуется оплата с типом тура ''Индивидуально'', то в настройку необходимо добавить ключ ''0'' | ||
| + | |||
| + | ===Настройки подключения и параметров используемых платежных систем модуля EntryPoint=== | ||
| + | Настройка подключения и параметров используемых платежных систем производится в конкретной секции платежной системы. | ||
| + | |||
| + | ====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 | ||
| + | | '''Точки продажи''' ('''shop_ID''') | ||
| + | Обязательная настройка. | ||
| + | | '''Shop_ID''' из раздела Точки продажи ЛК «Alfabank». | ||
| + | |<syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="shop_id" value="32565" /> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | |||
| + | | 2 | ||
| + | | '''Логин''' | ||
| + | Обязательная настройка. | ||
| + | | '''Login''' из раздела Параметры авторизации ЛК «Alfabank». | ||
| + | |<syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="login" value="megatec" /> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | |||
| 3 | | 3 | ||
| + | | '''Пароль''' | ||
| + | Обязательная настройка. | ||
| + | | '''Password''' из раздела Параметры авторизации ЛК «Alfabank». | ||
| + | |<syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="password" value="ХХХХХХХХХХ" /> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | |||
| + | | 4 | ||
| + | | Настройка, определяющая '''язык''' окна платежной формы «Alfabank». | ||
| + | Обязательная настройка. | ||
| + | | | ||
| + | * '''ru''' - русский язык | ||
| + | * '''en''' - английский язык | ||
| + | |<syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="language" value="ru" /> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | |||
| + | | 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> | ||
| + | Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства). | ||
| + | | | ||
| + | Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). | ||
| + | Комиссия указывается в процентах. | ||
| + | | <syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="addAgencyComission" value="15,8" /> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | |||
| + | | 7 | ||
| + | |Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br> | ||
| + | | | ||
| + | Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). | ||
| + | Комиссия указывается в процентах. | ||
| + | | <syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="addPersonalComission" value="17,4" /> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | |||
| + | | 8 | ||
| + | | Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''. | ||
| + | Обязательная настройка. | ||
| + | | '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>). | ||
| + | |<syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="masterTourUser" value="0" /> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | |||
| + | | 9 | ||
| + | | Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''. | ||
| + | Обязательная настройка. | ||
| + | | '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>). | ||
| + | |<syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="departmentKey" value="0" /> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | |||
| + | | 10 | ||
| + | | Настройка, включающая расчет через Мастер финанс. | ||
| + | | | ||
| + | * '''false''' - расчет через мастер финанс не включен; | ||
| + | * '''true''' - расчет через мастер финанс включен. | ||
| + | |<syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="AddPaymentsToMasterFinance" value="false"/> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | |||
| + | | 11 | ||
| + | | Настройка, определяющая '''тип операции при проведении платежа'''. | ||
| + | Обязательная настройка. | ||
| + | | '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>). | ||
| + | |<syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="PaymentOperationId" value="6" /> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | |- style="vertical-align:text-top" | ||
| + | |||
| + | | 12 | ||
| + | | Настройка, определяющая '''тип операции при проведении платежа для комиссий'''. | ||
| + | | '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>). | ||
| + | |<syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="paymentOperationCommissionId" value="" /> | ||
| + | </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 | ||
| + | | Настройка, определяющая '''адрес электронной почты по умолчанию'''. | ||
| + | |Используется в том случае, если не указан адрес электронной почты главного туриста. | ||
| + | |<syntaxhighlight lang="xml" enclose="div"> | ||
| + | <add key="defaultEmail" value="" /> | ||
| + | </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> | ||
| + | * 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 или запросить информацию в технической поддержке Альфа-Банка<br /> | ||
| + | |||
| + | ====Sberbank==== | ||
| + | Настройки задаются в секции <code><Sberbank></code> файла <code>web.config</code> приложения '''EntryPoint'''. При использовании SberbankMir или SberbankMir необходимо заполнить соответствующие секции в файле <code>web.config</code>. | ||
| + | <br /><br /> | ||
| + | |||
| + | Также поддерживается прием оплат через платежную систему '''Юкасса''' с использованием '''API Сбербанка'''. | ||
| + | В данном случае клиент подключает в Юкасса возможность работы по API Сбербанка, после чего Юкасса выдает: | ||
| + | * '''логин''' | ||
| + | * '''пароль''' | ||
| + | * '''ссылку на платежный шлюз''' | ||
| + | |||
| + | При использовании Юкасса по API Сбербанка необходимо указать в настройках секции <code><Sberbank></code> логин и пароль, выданные Юкасса, а также заменить ссылку на платежный шлюз на предоставленную Юкасса. | ||
| + | <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 | ||
| + | | Идентификатор клиента, который выдается платежной системой Sberbank.<br /><br /> | ||
| + | При использовании '''Юка | ||