msp3Prodamus

msp3Prodamus подключает Prodamus (payform) к MiniShop3 в MODX Revolution 3. Покупатель переходит на страницу оплаты payform. Статус «оплачен» выставляет MiniShop3. Пакет сам статус заказа не меняет. Письма покупателю шлёт Центр уведомлений MiniShop3.

Сумма уходит в рублях, с двумя знаками после запятой. Двухстадийной оплаты у Prodamus нет.

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

• Самостоятельная интеграция
• Уведомления
• Секрет и URL

Возможности

• Один способ: Оплата через Prodamus. Пакет создаёт ссылку на вашу страницу payform.
• Уведомление приходит формой. Подпись в заголовке Sign считается секретом этой страницы. Сайт отвечает кодом 200 и текстом success.
• Чек 54-ФЗ уходит в составе корзины: налог, способ расчёта и предмет расчёта.
• Во вкладке заказа только список попыток. Возврат, отмена и запрос статуса в Prodamus не уходят: таких запросов у сервиса нет.

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

Требование	Версия
MODX Revolution	3.0+
MiniShop3	1.14.0-beta1 и новее
PHP	8.2+
Кабинет	URL страницы payform и секрет со страницы настроек
Контакт	email или телефон в заказе. Без телефона Prodamus покажет предварительную форму
Сайт	HTTPS на webhook без 301

Зависимости

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

Установка

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

Резолвер создаёт способ Оплата через Prodamus, класс Msp3Prodamus\Payment\ProdamusPayment.

Секрет и URL страницы положите в msPayment.properties (secret или secret_key, payform_url). Если properties пусты, пакет читает системные настройки.

Откуда брать значения:

• URL страницы. Адрес платёжной страницы из адресной строки, обычно https://имя.payform.ru/. Это msp3prodamus_payform_url.
• Секрет. Войдите на платёжную страницу, нижнее меню Настройки, скопируйте секретный ключ. Новый ключ в кабинете не выпускается, его выдаёт поддержка Prodamus. Инструкция: где найти секрет и URL уведомлений.
• sys. Код интеграции. Его согласуют с поддержкой Prodamus. Один код на всю интеграцию. Без него Prodamus не примет urlNotification из запроса ссылки.
• URL уведомлений. На той же странице настроек поле Настройка уведомлений. После ввода нажмите сохранить.

Подробнее: Быстрый старт.

Заказ дешевле 1 копейки пакет на оплату не отправляет.

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

В кабинете один URL на страницу:

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

HTTPS без Basic Auth и без 301. Prodamus шлёт multipart/form-data. JSON-маршрут ядра MiniShop3 для form POST не подходит.

Переход на urlSuccess оплату не подтверждает. Факт оплаты это только webhook с верным Sign.

Архитектура

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

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