msp3PayKeeper

msp3PayKeeper подключает PayKeeper к MiniShop3 в MODX Revolution 3. Статус «оплачен» выставляет MiniShop3. Пакет сам статус заказа не меняет.

Сумма уходит в рублях, с двумя знаками после запятой. В запросах к PayKeeper логин и пароль те же, что для входа в кабинет.

Пространство имён настроек: msp3paykeeper. Точка входа уведомлений: assets/components/msp3paykeeper/webhook.php.

Возможности

• Счёт: покупатель переходит на страницу PayKeeper. Способ Оплата через PayKeeper.
• Холд: способ Оплата через PayKeeper (двухстадийная). В кабинете PayKeeper включите двухэтапный режим. Пока в уведомлении есть дата блокировки и нет списания, заказ ещё не оплачен.
• Возврат идёт по номеру платежа из уведомления, не по номеру счёта.
• Неоплаченный счёт можно отменить во вкладке заказа.
• Во вкладке: попытки, возврат, списание холда, отмена счёта, синхронизация.

Системные требования

Требование	Версия
MODX Revolution	3.x
MiniShop3	1.14.0-beta1 и новее
PHP	8.2+
pdoTools (установщик пакета)	3.0.0 и новее
Сайт	HTTPS на webhook без 301

Сниппетов нет. pdoTools есть в зависимостях транспорта, в коде не вызывается.

Для чека 54-ФЗ с корзиной в счёте нужен email в заказе, если включён msp3paykeeper_payment_receipt. Без email счёт создаётся, блок cart в service_name не уходит. Подробнее: Интеграция.

Зависимости

• MiniShop3: заказы и способы оплаты.

Установка

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

При установке пакет создаёт два способа оплаты. server_url, логин, пароль API и секретное слово сначала из msPayment.properties, иначе из системных настроек. Та же цепочка у send(), вкладки заказа и подписи на webhook.php.

Плагин msp3paykeeper_bootstrap: события OnMODXInit (autoload) и msOnManagerCustomCssJs (вкладка заказа).

Название	Класс
Оплата через PayKeeper	Msp3PayKeeper\Payment\PayKeeperPayment
Оплата через PayKeeper (двухстадийная)	Msp3PayKeeper\Payment\PayKeeperTwoStagePayment

Нужны URL, логин, пароль API и секретное слово. Где взять: Быстрый старт.

Быстрая настройка webhook

В кабинете PayKeeper один URL уведомлений. Ядро MiniShop3 на /api/v1/payment/webhook/{id} ждёт JSON. В кабинете укажите пакетный обработчик: PayKeeper шлёт form POST.

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

HTTPS без Basic Auth и без 301.

Архитектура

Быстрые ссылки

Нужно	Документ
Установить и принять первый платёж	Быстрый старт
Все ключи msp3paykeeper_*	Системные настройки
Webhook, чеки, двухстадийная, возврат	Интеграция
Заказ не оплачен, токен 401	FAQ
Оформление заказа MS3	MiniShop3: заказ