Платежные web-сервисы: Сервис интеграции с платежной системой Alfabank (оплата картой в личном кабинете) — различия между версиями
[непроверенная версия] | [непроверенная версия] |
Kiriy (обсуждение | вклад) (→Настройка) |
Kiriy (обсуждение | вклад) (→Настройка) |
||
Строка 110: | Строка 110: | ||
|} | |} | ||
+ | |||
+ | ===Настройки приложения «Система онлайн платежей»=== | ||
+ | Настройки задаются в секции <code><Tinkoff></code> файла <code>web.config</code> приложения '''Система онлайн платежей'''. | ||
+ | |||
+ | {| 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 | ||
+ | | '''Адрес платежной службы''' | ||
+ | Обязательная настройка. | ||
+ | | Адрес сервиса оплаты через карту банка «Tinkoff». | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 2 | ||
+ | | '''Идентификатор терминала''' | ||
+ | Обязательная настройка. | ||
+ | | Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff». | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="TerminalKey" value="1587990738"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 3 | ||
+ | | '''Пароль терминала''' | ||
+ | Обязательная настройка. | ||
+ | | Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff». | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 4 | ||
+ | | Настройка, определяющая '''язык''' окна платежной формы «Tinkoff». | ||
+ | Обязательная настройка. | ||
+ | | | ||
+ | * '''ru''' - русский язык | ||
+ | * '''en''' - английский язык | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="LanguageFormCode" value="ru"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 5 | ||
+ | | Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей. | ||
+ | | | ||
+ | * '''osn''' – общая система налогообложения | ||
+ | * '''usn_income''' – упрощенная система налогообложения (Доход) | ||
+ | * '''usn_income_outcome''' – упрощенная СН (Доход минус Расход) | ||
+ | * '''patent''' – патентная система налогообложения | ||
+ | * '''envd''' – единый налог на вмененный доход | ||
+ | * '''esn''' – единый сельскохозяйственный налог | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="TaxationCode" value="osn"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 6 | ||
+ | | Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей. | ||
+ | | | ||
+ | * '''none''' – не облагается НДС | ||
+ | * '''vat0''' – облагается НДС по ставке 0% | ||
+ | * '''vat10''' – облагается НДС по ставке 10% | ||
+ | * '''vat20''' – облагается НДС по ставке 20% | ||
+ | * '''vat110''' – облагается НДС по ставке 10/110 | ||
+ | * '''vat120''' – облагается НДС по ставке 18/120 | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="Tax" value="none"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 7 | ||
+ | | Настройка, определяющая '''тип операции при проведении платежа'''. | ||
+ | Обязательная настройка. | ||
+ | | '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="PaymentOperationId" value="6" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 8 | ||
+ | | Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''. | ||
+ | Обязательная настройка. | ||
+ | | '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="masterTourUser" value="80" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 9 | ||
+ | | Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''. | ||
+ | Обязательная настройка. | ||
+ | | '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="paymentFilialKey" value="1" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 10 | ||
+ | | Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''. | ||
+ | Обязательная настройка. | ||
+ | | '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="departmentKey" value="2" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 11 | ||
+ | |Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br> | ||
+ | | | ||
+ | * '''false''' или '''отсутствие настройки''' - комиссия не взимается; | ||
+ | * '''true''' - процент комиссии по договору с платежной системой добавляется к стоимости путёвки. Для проведения платежей "комиссия сверху" необходим дополнительный терминал с настройками для данной схемы подключения, необходимо обращаться в службу поддержки Tinkoff. | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="addAgencyComission" value="false" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 12 | ||
+ | |Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br> | ||
+ | | | ||
+ | * '''false''' или '''отсутствие настройки''' - комиссия не взимается; | ||
+ | * '''true''' - процент комиссии по договору с платежной системой добавляется к стоимости путёвки. Для проведения платежей "комиссия сверху" необходим дополнительный терминал с настройками для данной схемы подключения, необходимо обращаться в службу поддержки Tinkoff. | ||
+ | | <syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="addPersonalComission" value="false" /> | ||
+ | </syntaxhighlight> | ||
+ | |} | ||
+ | <br /> |
Версия 15:14, 2 августа 2022
Версия статьи от 2-08-2022.
Поддерживаемые версии ПК «Мастер-Тур»: |
Содержание
Введение
Данный модуль реализует возможность оплаты путевок через систему электронных платежей «Alfabank».
Установка
Для установки дополнительного модуля Сервис интеграции с платежной системой «Alfabank» нужно создать директорию Alfabank в каталоге C:/inetpub/wwwroot
(корневом каталоге IIS) и выложить туда распакованные файлы из архива
payments-alfabank-XX.X.X.XXXXX.zip
.
Устанавливать дополнительный модуль необходимо в том же домене, где расположено основное приложение ПК «Мастер-Web».
Начиная с релиза 15.5, если используется дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете), то необходимо скопировать файл Megatec.MasterWeb.PaymentSystem.Alfabank.dll
из /Payments/bin/
и разместить в папке /EntryPoint/bin/
.
В управлении IIS необходимо создать виртуальный каталог для папки Alfabank.
Создание виртуального каталога
По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot
. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:
1 Зайти в Пуск (Start) → Настройки (Settings) → Панель управления (Control Panel) → Администрирование (Administrative Tools)
2 Диспетчер служб IIS
3 В открывшемся дереве каталогов выбрать Web Sites – Default Web Site. В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и выбрать Преобразовать в приложение
4 В открывшемся окне нужно нажать кнопку ОК
Подключение к базе данных ПК «Мастер-Тур»
В файле web.config
, расположенном в папке Alfabank пропишите необходимые параметры подключения (красным цветом выделены значения, которые необходимо ввести).
Строка подключения к базе данных ПК «Мастер-Тур»:
<add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК «Мастер-Тур»;Initial Catalog=название базы данных ПК «Мастер-Тур»;User ID=логин пользователя ПК «Мастер-Тур»;Password=пароль пользователя ПК «Мастер-Тур»"/>
Настройка
После установки Сервис интеграции с платежной системой Alfabank доступен в экранах «Список заявок» и «Информация о заказе».
Настройки ПК «Мастер-Web»
Настройки задаются в секции <appSettings>
файла web.config
основного приложения ПК «Мастер-Web».
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Включение дополнительного модуля Система онлайн платежей.
Обязательная настройка. |
Путь к приложению «Система онлайн платежей». | <add key="paymentsLink" value="http://localhost/Alfabank" />
|
2 | Настройка, определяющая статусы путевок, при которых доступна возможность оплаты через систему электронных платежей «Alfabank».
Обязательная настройка. |
Ключи статусов из таблицы [Order_Status] , при которых доступна оплата через «Alfabank».
|
<add key="paymentsStatuses" value="7,33" />
|
3 | Настройка, позволяющая выводить предупреждающее сообщение о снятии комиссии при оплате. |
|
<add key="askUserBeforePayment" value="true" />
|
4 | Настройка, включающая механизм хэширования пароля пользователя, сохраняемого в файлах cookie , что позволяет усилить безопасность ПК «Мастер-Web».
По умолчанию хэширование включено. |
|
<add key="HashPasswordForCookie" value="true" />
|
5 | Настройка, определяющая партнеров в базе ПК «Мастер-Тур», которым разрешено осуществлять оплату путёвок онлайн.
|
|
<add key="allowedPaymentPartnerKeys" value="10764"/>
|
Настройки приложения «Система онлайн платежей»
Настройки задаются в секции <Tinkoff>
файла web.config
приложения Система онлайн платежей.
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Адрес платежной службы
Обязательная настройка. |
Адрес сервиса оплаты через карту банка «Tinkoff». | <add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
|
2 | Идентификатор терминала
Обязательная настройка. |
Параметр Терминал из раздела Терминалы в л/к сервиса «Tinkoff». | <add key="TerminalKey" value="1587990738"/>
|
3 | Пароль терминала
Обязательная настройка. |
Параметр Пароль из раздела Терминалы в л/к сервиса «Tinkoff». | <add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
|
4 | Настройка, определяющая язык окна платежной формы «Tinkoff».
Обязательная настройка. |
|
<add key="LanguageFormCode" value="ru"/>
|
5 | Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей. |
|
<add key="TaxationCode" value="osn"/>
|
6 | Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей. |
|
<add key="Tax" value="none"/>
|
7 | Настройка, определяющая тип операции при проведении платежа.
Обязательная настройка. |
Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="PaymentOperationId" value="6" />
|
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 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) |
|
<add key="addAgencyComission" value="false" />
|
12 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) |
|
<add key="addPersonalComission" value="false" />
|