msp3WebPay

Оплата через WEBPAY для MiniShop3
Автор дополнения
Иван Бочкарев
Пакетов
44
Закачек
288
Обычно отвечает в течение суток
Автор дополнения
Пакетов
44
Закачек
288
Обычно отвечает в течение суток
Версия 2.0.0-pl
Дата выпуска 25.09.2026
Загрузки 0
Просмотры 4
Внимание, этот компонент требует 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.

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