Skip to content
  1. Компоненты
  2. mspBePaid

mspBePaid

Начало работы

Для того, чтобы принимать оплату с помощью bePaid необходимо сначала подать заявку на регистрацию в системе.

Помощь по интеграции модуля оплаты на сайт вы можете получить через службу технической поддержки либо напрямую у разработчика в Минске либо через техническую поддержку самой платежной системы.

Системные требования

  • PHP 5.5+
  • MODX Revolution 2.4+
  • MiniShop2

Настройка bePaid

Важно

Для проверки механизма платежей пользуйтесь только тестовым окружением.

Для начала следует ознакомиться с требованиями к сайтам и интернет-магазинам:

Так же вы можете запросить у менеджеров платежной системы дополнительные документы для ознакомления:

  • Список документов
  • Анкета клиента (ИП)
  • Анкета клиента (Юридическое лицо)
  • Эквайринговый договор (интернет-магазин)
  • Эквайринговый договор (интернет-ресурс)

Достаточно написать письмо на адрес sales@bepaid.by или позвонить по телефонам +375 (17) 277-01-18, +375 (29) 664-00-24 (Республика Беларусь).

Для успешной работы с платежной системой вам понадобится логин и пароль, выданные после регистрации. Для начала необходимо зайти в панель управления и произвести первичную настройку системы согласно инструкции, предоставленной сотрудниками bePaid.

Установка и настройка пакета в MODX

При установке пакета установщик предлагает ввести реквизиты тестового магазина для начала работы с платежной системой bePaid в MODX. Если вы уже зарегистрировались и получили все необходимые реквизиты, вы можете указать в этом окне настоящие идентификатор магазина и секретный ключ.

Можно пропустить этот шаг и заполнить эти данные позже в системных настройках.

Затем нужно включить метод оплаты в настройках miniShop2 и добавить его к необходимому методу доставки. Если у вас уже действующий магазин на MODX и MiniShop2 - настройка на этом закончена. Если же вы делаете новый сайт - то о том, как работать с платежными системами в miniShop2 следует ознакомиться в документации по miniShop2 или задать вопрос на сайте modx.pro.

Чтобы перевести режим оплат из тестового в «боевой», измените системную настройку ms2_payment_bepaid_test_mode с «Да» на «Нет».

Для более тонкой настройки платежного модуля существует целый набор системных настроек в соответствующем разделе MODX. Для выбора настроек следует выбрать пространство имен minishop2 и раздел bePaid.

Дополнительно с данным платежным модулем поставляется несколько плагинов для улучшения работы с системными настройками. Например, не нужно вписывать номер ресурса или статуса руками в текстовое поле, достаточно дважды кликнуть по значению и выбрать соответствующий вариант из выпадающего списка.

ЕРИП и Халва

С версии модуля 2.2.0 поддерживается работа с картами "Халва" от МТБанк и выставление счетов в системе "Расчет" (ЕРИП).

В модуле реализованы два способа добавления новых методов оплаты на сайт.

Первый и самый простой - добавить необходимые методы в системную настройку ms2_payment_bepaid_payment_types.

Возможные значения указываются через запятую. Если поле пустое, по умолчанию используется значение credit_card.

  • credit_card - оплата банковской картой
  • erip - оплата через ЕРИП
  • halva - оплата картой рассрочки "Халва"

Кроме того, для того, чтобы правильно выставить счет в системе "Расчет" (ЕРИП), необходимо знать номер услуги, присвоенный продавцу в системе и указать его в настройке ms2_payment_bepaid_erip_service_id. Для тестирования можно использовать значение 99999999. Важно отметить, что из-за особенностей ЕРИП, тестирование таких платежей стоит проводить только на доступном в сети сайте.

При переходе на сайт платежной системы это будет выглядеть так.

Второй способ, это добавить в настройках магазина новые способы оплаты, отдельный для карты "Халва" и отдельный для ЕРИП, и предоставить покупателю выбор на странице оформления заказа. Оба новых метода наследуют базовый класс, но в них по умолчанию предустановлен определенный тип оплаты.

Справочник по системным настройкам

Важно! В таблице ниже, для лучшей читаемости, ключи настроек представленны в коротком виде, без префикса **ms2_payment_bepaid**._

ОписаниеКлючЗначение по умолчанию
Идентификатор магазина в системе bePaid Данный идентификатор создается при регистрации в системе bePaid и высылается в письме.store_id
Секретный ключ Последовательность случайных символов, участвует в формировании электронной подписи заказа, выдается при регистрации магазина в системе bePaid.secret_key
Язык bePaid Выберите язык, на котором показывать сайт bePaid при оплате. По умолчанию будет использоваться язык, установленный для сайта в системной настройке cultureKey.languageru
Страна по умолчанию Выберите страну, которая будет использоваться по умолчанию при совершении оплаты. Выбор страны можно переопределить через корзину. Рекомендуется выбирать страну, где расположен магазин.countryby
Статус заказа в случае успешной оплаты Если заказ обработан без ошибок и со стороны банка транзакция авторизована, статус заказа будет изменен на указанный.success_status2
Статус заказа в случае ошибок оплаты Если заказ не обработан или были ошибки в процессе оплаты, статус заказа будет изменен на указанный.failure_status4
Страница успешной оплаты bePaid Пользователь будет отправлен на эту страницу после успешного завершения оплаты. Рекомендуется указать страницу с корзиной для вывода деталей заказа.success_page0
Страница отмены оплаты bePaid Пользователь будет отправлен на эту страницу при неудачной оплате. Рекомендуется указать страницу с корзиной для вывода деталей заказа.failure_page0
Валюта платежа Буквенный трехзначный код валюты согласно ISO 4271.currencyBYR
Входная точка API URL, куда будут отправляться запросы на оплату.checkout_url https://checkout.bepaid.by/ctp/api/checkouts
Режим совершения тестовых платежей При значении "Да", все запросы оплаты будут отправляться на тестовую среду обработки платежей bePaid. Реальные карты в данном режиме не работают.test_modeДа
Свойства заказа только для чтения Поля заказа, перечисленные в данном параметре, на странице оплаты будут доступны только для чтения (редактировать нельзя). Список доступных полей (указывается через запятую): email, first_name, last_name, address, city, state, zip, phone, country.readonly_fieldsemail
Скрытые свойства заказа Поля заказа, перечисленные в данном параметре, будут скрыты на странице оплаты, но при это будут записаны в параметры платежа. Список доступных полей (указывается через запятую): phone, address.hidden_fields
Версия платежной страницы На текущий момент актуальная версия протокола 2.1. Если вы устанавливали компонент ранее, это значение следует обновить вручную.api_version2.1
Доступные способы оплаты Массив способов оплаты для отображения на странице оплаты. Доступны следующие значения: credit_card, erip, halva. Для ЕРИП так же необходимо указать значение erip_service_id.payment_types
Код услуги ЕРИП Уникальный код магазина или услуги, зарегистрированной для продавца в системе "Расчет". Для тестов используйте значение: 99999999.erip_service_id