mspBePaid

Купить mspBePaid в магазине дополнений →
04 декабря 2017, 10:16

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

Для того, чтобы принимать оплату с помощью 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_paymentbepaid._

Описание Ключ Значение по умолчанию
Идентификатор магазина в системе bePaid Данный идентификатор создается при регистрации в системе bePaid и высылается в письме. store_id
Секретный ключ Последовательность случайных символов, участвует в формировании электронной подписи заказа, выдается при регистрации магазина в системе bePaid. secret_key
Язык bePaid Выберите язык, на котором показывать сайт bePaid при оплате. По умолчанию будет использоваться язык, установленный для сайта в системной настройке cultureKey. language ru
Страна по умолчанию Выберите страну, которая будет использоваться по умолчанию при совершении оплаты. Выбор страны можно переопределить через корзину. Рекомендуется выбирать страну, где расположен магазин. country by
Статус заказа в случае успешной оплаты Если заказ обработан без ошибок и со стороны банка транзакция авторизована, статус заказа будет изменен на указанный. success_status 2
Статус заказа в случае ошибок оплаты Если заказ не обработан или были ошибки в процессе оплаты, статус заказа будет изменен на указанный. failure_status 4
Страница успешной оплаты bePaid Пользователь будет отправлен на эту страницу после успешного завершения оплаты. Рекомендуется указать страницу с корзиной для вывода деталей заказа. success_page 0
Страница отмены оплаты bePaid Пользователь будет отправлен на эту страницу при неудачной оплате. Рекомендуется указать страницу с корзиной для вывода деталей заказа. failure_page 0
Валюта платежа Буквенный трехзначный код валюты согласно ISO 4271. currency BYR
Входная точка 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_fields email
Скрытые свойства заказа Поля заказа, перечисленные в данном параметре, будут скрыты на странице оплаты, но при это будут записаны в параметры платежа. Список доступных полей (указывается через запятую): phone, address. hidden_fields
Версия платежной страницы На текущий момент актуальная версия протокола 2.1. Если вы устанавливали компонент ранее, это значение следует обновить вручную. api_version 2.1
Доступные способы оплаты Массив способов оплаты для отображения на странице оплаты. Доступны следующие значения: credit_card, erip, halva. Для ЕРИП так же необходимо указать значение erip_service_id. payment_types
Код услуги ЕРИП Уникальный код магазина или услуги, зарегистрированной для продавца в системе "Расчет". Для тестов используйте значение: 99999999. erip_service_id

Следующий документ
Яндекс.Деньги