msp3WebPay

Оплата через WEBPAY для MiniShop3
Документация
Документация
Иван Бочкарев
Автор дополнения
Иван Бочкарев
Пакетов
44
Закачек
331
Обычно отвечает в течение суток
Автор дополнения
Иван Бочкарев Иван Бочкарев
Пакетов
44
Закачек
331
Обычно отвечает в течение суток

ms3FirstTimeBuyerDiscount

Автоматическая скидка на первый заказ пользователя

msBulkEditor

Массовое редактирование и фильтрация товаров MiniShop3

msp3PayKeeper

Оплата через PayKeeper для MiniShop3
Версия 2.0.0-pl
Дата выпуска 25.09.2026
Загрузки 0
Просмотры 70
Внимание, этот компонент требует PHP 8.2 или выше!
Внимание, этот компонент требует MODX 3 или выше.
Оплата через WEBPAY для MiniShop3 — карты, ЕРИП и двухстадийная оплата

msp3WebPay подключает WEBPAY к MiniShop3 в MODX 3 и позволяет принимать оплату заказов через банковские карты и ЕРИП.

Покупатель оформляет заказ в магазине, выбирает WEBPAY и переходит на страницу оплаты. Результат операции передаётся в MiniShop3 через webhook, после чего стандартная система MiniShop3 обрабатывает оплату и меняет статус заказа.

Что поддерживает msp3WebPay

  • Оплата банковской картой — деньги списываются сразу.
  • ЕРИП — отдельный способ оплаты через WEBPAY.
  • Двухстадийная оплата — сначала блокировка средств, затем списание.
  • Webhook для получения результата операции от WEBPAY.
  • Определение оплаты, отказа, возврата и отмены по уведомлению WEBPAY.
  • Возврат покупателя на сайт после оплаты.
  • Хранение попыток оплаты в MiniShop3.
  • Тестовый режим WEBPAY для проверки интеграции.

Два сценария оплаты

Обычная оплата — покупатель оплачивает заказ картой, средства списываются сразу.

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

Это удобно для магазинов, где окончательное списание выполняется только после проверки наличия товара или возможности выполнить заказ.

ЕРИП

msp3WebPay добавляет отдельный способ оплаты через ЕРИП. Покупатель получает возможность оплатить заказ через инфраструктуру WEBPAY.

Для ЕРИП учитывается особенность WEBPAY с номером заказа: пакет автоматически добавляет префикс WP- в предусмотренном документацией случае.

Webhook

Результат платежа обрабатывается серверным уведомлением WEBPAY.

Возврат покупателя в браузере сам по себе не считается подтверждением оплаты — источником результата является уведомление платёжной системы.

Тестовый режим

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

Интеграция с MiniShop3

msp3WebPay работает через стандартный механизм способов оплаты MiniShop3 и не изменяет ядро магазина.

Статусы заказа после оплаты определяются штатными настройками MiniShop3.

Требования

  • MODX Revolution 3.0+;
  • MiniShop3 1.14.0-beta1+;
  • PHP 8.2+;
  • pdoTools 3.x;
  • HTTPS для webhook;
  • доступ к кабинету WEBPAY.

1. Подключение WEBPAY

Официальный сайт WEBPAY: https://webpay.by/

На сайте WEBPAY оставьте заявку на подключение онлайн-оплаты. После подключения WEBPAY предоставляет доступ в тестовую среду и настройки для работы. Для перехода в production необходимо завершить подключение и получить настройки рабочей среды.

2. Что получить у WEBPAY

Для настройки дополнения понадобятся:

  • ID магазина (`wsb_storeid`) — предоставляется WEBPAY.
  • Секретный ключ — задаётся в кабинете WEBPAY: Настройки → Компания → Секретный ключ.
  • API-логин и пароль — необходимы для операций через API кабинета, включая подтверждение, отмену и возврат.

Тестовый кабинет: https://sandbox.webpay.by/

Рабочий кабинет: https://billing.webpay.by/

3. Настройка MODX

Откройте: Система → Настройки → Системные настройки

Фильтр: msp3webpay

Основные параметры:

  • msp3webpay_store_id
  • msp3webpay_secret_key
  • msp3webpay_test

Для API-операций:

  • msp3webpay_api_username
  • msp3webpay_api_password


4. URL уведомлений

В настройках WEBPAY укажите:

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


URL должен быть доступен по HTTPS и не должен перенаправляться через HTTP 301.

5. Тестирование

  1. Укажите тестовые реквизиты WEBPAY.
  2. Включите msp3webpay_test.
  3. Настройте webhook.
  4. Создайте тестовый заказ в MiniShop3.
  5. Проверьте получение серверного уведомления и изменение состояния заказа.

6. Production

После завершения тестирования:

  • укажите рабочий ID магазина и секретный ключ;
  • укажите рабочие API-реквизиты;
  • отключите тестовый режим;
  • проверьте webhook на рабочем домене;
  • выполните контрольный платеж.

После изменения системных настроек очистите кэш MODX.

All notable changes to msp3WebPay are documented here. Format follows Keep a Changelog.

[2.0.0] - 2026-09-24

Added

  • WEBPAY integration for MiniShop3: card (one-stage), ERIP, two-stage hold.
  • Payment JSON API via stream HTTP (payment_standard, payment_Erip).
  • HTML form checkout (pay.php) if JsonPaymentApi returns 404. Official form POST to securesandbox/payment.webpay.by.
  • Operations API: login, complete (capture), cancel (void/refund).
  • Form POST webhook with MD5 notify signature.
  • Manager tab: capture, void, refund, sync attempts.
  • return.php buyer redirect endpoint.
  • Unit tests: Signature, OrderNumber, TestData, WebhookParser, Contract.

Changed

  • Replaced payment skeleton with WEBPAY provider logic.
  • Credentials priority: msPayment.properties then system settings.
  • Payment attempt payload stores wt, webpay_order_num, transaction_id via lifecycle (not order properties).
  • Package version 2.0.0.

Removed

  • OrderStatusUpdater и запись status_id.

Dependencies

  • MODX 3.x, MiniShop3 >= 1.14.0-beta1, PHP >= 8.2.

[1.0.0] - 2026-03-01

Первая MiniShop3-сборка msp3WebPay (ещё с OrderStatusUpdater).

Последние обсуждения в сообществе MODX.pro