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 и новее
pdoTools3.0.0 и новее
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. Если поле пустое, проверка подписи не выполняется. Basic Auth для webhook всё равно обязателен.

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

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

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

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

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

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

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

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

HTTPS без 301. Пакет при создании ссылки передаёт этот URL в поле notification_url токена checkout. Оба адреса должны совпадать.

Покупатель после оплаты попадает на:

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

Этот адрес пакет подставляет в success_url, decline_url, fail_url и cancel_url checkout. Страница сверяет токен и может догнать оплату в MiniShop3, если webhook опоздал. Источник истины — webhook.

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

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

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

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

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