Быстрый старт

Как принять первый платёж через CloudPayments на сайте с MiniShop3.

Требования

Требование	Версия
MODX Revolution	3.0+
MiniShop3	1.14.0-beta1 и новее
PHP	8.2+
Доступ	Public ID и API Secret сайта
Чек 54-ФЗ	email в заказе
Сайт	HTTPS на webhook без 301

Тестовые и боевые ключи не смешивайте. Public ID виджета test_api_00000000000000000000001 для создания счетов не подходит.

Шаг 1: Провайдер modstore и установка пакета

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

Резолвер создаёт два активных способа. Старый mspCloudPayments, если он уже стоит, не удаляется.

Название	Класс
Оплата через CloudPayments	Msp3CloudPayments\Payment\CloudPaymentsPayment
Оплата через CloudPayments (двухстадийная)	Msp3CloudPayments\Payment\CloudPaymentsTwoStagePayment

Откуда брать ключи

Public ID и API Secret берутся в кабинете CloudPayments у сайта. Точный пункт меню в README пакета не назван.

В MODX это msp3cloudpayments_public_id и msp3cloudpayments_api_secret. Тем же секретом пакет проверяет подпись уведомлений. В properties способа те же значения можно положить как public_id и api_secret (также secret и webhook_secret). Непустые properties перекрывают системные настройки.

Если свой адрес API пуст, пакет ходит на https://api.cloudpayments.ru.

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

1. Настройки → Системные настройки, фильтр msp3cloudpayments.
2. Вставьте Public ID и API Secret. Для теста берите тестовые ключи сайта, не ключ виджета из примеров.
3. После сохранения: Управление → Очистить весь кеш.

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

Шаг 3: Шесть адресов уведомлений

В кабинете укажите все шесть. HTTPS без 301.

Тип	URL
Pay	https://ваш-домен.ru/assets/components/msp3cloudpayments/webhook.php?event=pay
Check	https://ваш-домен.ru/assets/components/msp3cloudpayments/webhook.php?event=check
Fail	https://ваш-домен.ru/assets/components/msp3cloudpayments/webhook.php?event=fail
Confirm	https://ваш-домен.ru/assets/components/msp3cloudpayments/webhook.php?event=confirm
Refund	https://ваш-домен.ru/assets/components/msp3cloudpayments/webhook.php?event=refund
Cancel	https://ваш-домен.ru/assets/components/msp3cloudpayments/webhook.php?event=cancel

Неверная подпись или пустое тело Pay отвечают кодом 13.

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

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

Если рядом стоит старый mspCloudPayments, выключите его и пропишите новые адреса. Подробнее: Переход.

Шаг 5: Тестовая карта и бой

Тестовая карта: 4242 4242 4242 4242. Это успешная оплата с 3-D Secure. Срок и CVC любые корректные.

На бою:

1. Боевые Public ID и API Secret.
2. Те же шесть адресов из шага 3.
3. Контрольный платёж. Уведомление Pay со статусом Completed должно отметить попытку оплаченной.
4. Выключите msp3cloudpayments_debug.

Холд не делает заказ оплаченным, пока не спишете его во вкладке заказа или не придёт Confirm.