Для WebStore реализовано два способа работы с платежами:
- Оплата заказов через эквайринг - оплата происходит на прямую при помощи банковской платежной карты. Банк обеспечивает приём платежей от покупателей и их перевод на расчётный счёт юридического лица.
- Оплата заказов через Службу платежей - оплата происходит через Службу платежей. Служба платежей обеспечивает эквайринг.
¶ Общие настройки
Об общих настройках платежных шлюзов подробнее в статье Параметры конфигурации WebStore
Настройка возможно в конфигурационном файле или на административной странице WebStore
¶ 1. Настройка в файле конфигурации
В конфигурационный файл с настройками Webstore включает блок настроек эквайрингов "Acquiring". В данный блок в формате json добелены настройки каждого доступного в системе экваринга. Настройки включают в себя список параметров необходимых для корректной работы эквайринга. Значения параметров могут быть отредактированы в связи с изменениями. Подробнее о настройках параметров для конкретных эквайрингов в разделе “Эквайринги” статьи Служба платежей . Для каждого эквайринга список параметров является индивидуальным.
Пример настроек в конфигурационном файле.
"Acquiring": {
"UseHold": false,
"Merchants": [
{
"ShopID": "00009733",
"Login": "login",
"Password": "password",
"PayPageUrl": "https://wpay.uniteller.ru/pay/",
"RegisterPaymentUrl": "",
"ConfirmPaymentUrl": "https://wpay.uniteller.ru/confirm/",
"CancelPaymentUrl": "https://wpay.uniteller.ru/cancel",
"PaymentResultUrl": "https://wpay.uniteller.ru/results",
"MobilePaymentRequestUrl": "",
"MobilePaymentResultUrl": "",
"TaxDictionary": "",
"VatDictionary": "",
"TimeZone": "Russian Standard Time",
"RegisterOrderType": 0,
"ID": 2, - идентификатор эквайринга в WebStore
"Acquirer": 2 - type (тип) эквайринга
}
]¶ 2. Настройка на административной странице WebStore
Администраторский раздел (расположен по адресу http://<адрес:порт_службы>/Admin ( http://localhost:9010/Admin )
Настройки ⇒ Эквайринги.
Блок раздела “Общие настройки для всех мерчантов” включают поля:
- Фискализовать оплату - выбор из выпадающего списка “Да” или “Нет”.
- Использовать операцию “Hold” - выбор из выпадающего списка “Да” или “Нет”.
При использовании настройки “Использовать операцию “Hold. Да” платежи замораживаются, но подтверждение платежа на WebStore не доступно. Замороженные платежи остаются в статусе “Зарегистрирован”. При тапе по статусу можно получить ошибку “Произошла ошибка в процессе получения результатов оплаты”.
Функционал по использованию двухстадийной оплаты в WebStore в разработке.
- настройки по умолчанию “Код системы налогообложения” и “Ставка системы налогообложения”.
Для добавления нового эквайринга нажать кнопку “Добавить мерчанта” и выбрать тип эквайринга из выпадающего списка. Для каждого эквайринга индивидуально добавляются поля с необходимыми параметрами. Пользователь вручную вносит только регистрационные данные в соответствии с требованиями банка (логин, пароль, секретный ключ, идентификатор учетной записи).
¶ 3. Список доступных мерчантов:
Подробнее об эквайрингах доступных через Службу платежей можно прочитать в статье Актуальность Службы платежей в модулях Барс (блок WebStore)
¶
¶ 4. Выбор эквайринга для оплаты заказов
Для того чтобы клиент при оплате переходил на платежную страницу определенного эквайринга необходимо:
- Перейти в папку Views
- Открыть папку Widget
- Открыть при помощи Блокнота файл WidgetHostPage.WebStore
- В файле в параметр merchantID добавить ID выбранного эквайринга (идентификатор эквайринга в WebStore)
- Данные сохранить
- Перезапустить WebStore
¶ Оплата заказов через банковский эквайринг
При выборе оплаты через эквайринг платежи не проходят через Службу платежей. Данные о платежах записываются в базу данных Webstore.
При оплате заказов в WebStore через банковский эквайринг не доступны:
- Двухстадийные платежи
- Частичный возврат
- Отмена платежа
Функционал в разработке.
¶ Оплата заказов через Службу платежей
Для того чтобы оплата проходила через Службу платежей необходимы следующие настройки:
¶ 1. Настройка в файле конфигурации
В конфигурационный файл с настройками Webstore в блоке настроек эквайрингов "Acquiring" по умолчанию добавлены настройки Службы платежей.
"Acquiring": {
"UseHold": true,
"Merchants": [
{
"BaseUrl": "http://localhost:10077",
"AcquiringIdWithinService": 37,
"Timeout": 600,
"ID": 8,
"Acquirer": 98
}
- ID - идентификатор Службы платежей на WebStore всегда 8
- Acquirer - тип эквайринга всегда 98
- AcquiringIdWithinService - идентификатор эквайринга в рамках Службы платежей. Посмотреть Id эквайринга можно в Барс Администратор (Внешние платежи ⇒ Эквайринги или при помощи API Службы платежей (метод GET /api/Acquirings )
На примере настроек выше в параметре AcquiringIdWithinService задан идентификатор агента СБП Райффайзенбанк/
Id эквайринга в Барс Администратор.
Id эквайринга полученного методом API
¶ 2. Настройка на административной странице WebStore
Также настроить оплату через Службу платежей можно на административной странице.
Администраторский раздел (расположен по адресу http://<адрес:порт_службы>/Admin ( http://localhost:9010/Admin )
Настройки ⇒ Эквайринги.
В настройках мерчанта с ID =8 (Служба платежей Барс) указать значение в параметре “ИД эквайринга в рамках службы платежей” равным id эквайринга в рамках Службы платежей.
¶ 3. Список доступных мерчантов:
Заказы Webstore оплаченные через Службу платежей отображаются в Журнале платежей Барс Администратор или могут быть получены при помощи API Службы платежей.
При выборе настройки “Фискализовать оплату. Да” платежи имеют чек. Платежи без фискализации отплаты чека не имеют.
При выборе настройки “Использовать операцию "Hold". Да” подтверждение платежа только через Барс Администратор или API Службы платежей.
Подробнее об эквайрингах доступных через Службу платежей можно прочитать в статье Актуальность Службы платежей в модулях Барс (блок WebStore)
Внимание!!! Операции “Подтверждение платежа”, “Возврат платежа (частичный или полный)”, а также “Отмена платежа ” совершенные в Барс Администратор или при помощи API Службы платежей с заказами WebStore имеют не корректные статусы на WebStore и не поддерживаются функционалом службы WebStore.
Функционал в разработке.