docs.modx.pro
msp3BePaid
Приём оплаты через bePaid для MiniShop3: ссылка на оплату, webhook и возврат покупателя в браузере
  • MODX 3
  • PHP 8.2
  • miniShop3
Зависимости
  • miniShop3
  1. Компоненты
  2. msp3BePaid
  3. Быстрый старт

Быстрый старт ​

Как принять первый платёж через bePaid на сайте с MiniShop3.

Требования ​

ТребованиеВерсия
MODX Revolution3.0+
MiniShop31.14.0-beta1 и новее
PHP8.2+
PHP-модульbcmath
ДоступShop ID, секретный ключ и публичный ключ магазина
СайтHTTPS на webhook без 301

Без bcmath пакет не переводит сумму заказа в мелкие единицы валюты.

Шаг 1: Провайдер modstore и установка пакета ​

  1. Система → Управление пакетами → Провайдеры → добавьте modstore.pro:
    • URL: https://modstore.pro/extras/
    • Email и API-ключ из личного кабинета modstore.pro
  2. Убедитесь, что установлен MiniShop3.
  3. Управление пакетами → установите msp3BePaid (в Show Details укажите провайдер modstore.pro).
  4. Управление → Очистить кэш.

Резолвер создаёт один активный способ.

НазваниеКласс
Оплата через BePaidMsp3BePaid\Payment\BePaidPayment

Откуда брать ключи ​

Shop ID и секретный ключ лежат в личном кабинете bePaid. Путь из документации API:

  1. Войдите в кабинет и откройте вкладку Магазины.
  2. У нужного магазина нажмите Подробнее.
  3. Shop ID это значение в строке ID. В MODX это msp3bepaid_store_id.
  4. Secret Key откроется по кнопке Показать секретный ключ магазина в секции Идентификационные данные. В MODX это msp3bepaid_secret_key.

Этими двумя значениями bePaid проверяет запросы к API и уведомления на сайт.

Публичный ключ нужен, чтобы проверить подпись уведомления в заголовке Content-Signature. Документация уведомлений говорит, что ключ берут в личном кабинете. Точный пункт меню там не назван. В MODX это msp3bepaid_public_key. Без ключа проверка подписи не работает. Логин и пароль магазина для приёма уведомления всё равно нужны.

В properties способа те же значения можно положить как store_id, secret_key, public_key. README пакета также называет webhook_secret. Непустые properties перекрывают системные настройки.

Валюта по умолчанию BYN. Тестовый платёж включается настройкой msp3bepaid_test: в запрос ссылки уходит "test": true.

Шаг 2: Куда вписать в MODX ​

  1. Настройки → Системные настройки, фильтр msp3bepaid.
  2. Заполните Shop ID, секретный ключ и публичный ключ.
  3. После сохранения: Управление → Очистить весь кеш.

Список полей: Системные настройки.

Шаг 3: Адреса webhook и возврата ​

В кабинете bePaid укажите один адрес уведомлений на магазин:

text
https://ваш-домен.ru/assets/components/msp3bepaid/webhook.php

HTTPS без 301. Покупатель после оплаты попадает на:

text
https://ваш-домен.ru/assets/components/msp3bepaid/return.php

Этот адрес пакет передаёт сам, с номером заказа и итогом (success, fail и другие). Страница возврата заказ не оплачивает. Оплату подтверждает webhook.

Шаг 4: Способ оплаты в MiniShop3 ​

  1. В админке MiniShop3 откройте Настройки → Оплаты.
  2. Включите Оплата через BePaid.
  3. Привяжите способ к доставке.

Для ERIP заполните тип в msp3bepaid_payment_types и номер услуги msp3bepaid_erip_service_id, если он нужен.

Шаг 5: Проверка ​

  1. Оформите заказ и откройте страницу оплаты bePaid.
  2. Дождитесь webhook. Пока его нет, заказ не оплачен, даже если браузер уже вернулся на сайт.
  3. Возврат во вкладке заказа доступен после этого уведомления.