docs.modx.pro
msp3CloudPayments
Приём оплаты через CloudPayments для MiniShop3: счёт, шесть уведомлений, одно- и двухстадийная схема
  • MODX 3
  • PHP 8.2
  • miniShop3
Зависимости
  • miniShop3
  1. Компоненты
  2. msp3CloudPayments

msp3CloudPayments ​

msp3CloudPayments подключает CloudPayments к MiniShop3 в MODX Revolution 3. Пакет создаёт счёт, покупатель переходит по ссылке. Статус «оплачен» выставляет MiniShop3. Пакет сам статус заказа не меняет.

Сумма уходит с двумя знаками после запятой. Валюта по умолчанию RUB.

Уведомление подписано секретом API. Эту проверку выключить нельзя. Чек 54-ФЗ, если он включён, уходит вместе со счётом. Для чека в заказе нужен email.

Старый пакет mspCloudPayments при установке не удаляется.

Пространство имён настроек: msp3cloudpayments. Уведомления: assets/components/msp3cloudpayments/webhook.php.

Возможности ​

  • Обычная оплата, деньги списываются сразу: способ Оплата через CloudPayments.
  • Холд, деньги сначала блокируются: способ Оплата через CloudPayments (двухстадийная). Заказ станет оплаченным после списания или уведомления Confirm.
  • Шесть адресов уведомлений: оплата, проверка, отказ, подтверждение, возврат, отмена.
  • Проверка перед оплатой статус заказа не меняет. Она ищет попытку и сверяет сумму.
  • Во вкладке заказа: списание холда, отмена холда, возврат, отмена неоплаченного счёта, запрос статуса у CloudPayments.
  • Номер счёта пакет сохраняет сам. Отмена неоплаченного счёта webhook не ждёт.

Тестовый Public ID виджета test_api_00000000000000000000001 для счетов не подходит.

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

ТребованиеВерсия
MODX Revolution3.0+
MiniShop31.14.0-beta1 и новее
PHP8.2+
ДоступPublic ID и API Secret сайта
Чек 54-ФЗemail в заказе
СайтHTTPS на webhook без 301

Зависимости ​

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

Установка ​

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

Резолвер создаёт два активных способа:

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

Ключи удобнее хранить в msPayment.properties: public_id, api_secret, secret, webhook_secret. Если properties пусты, пакет читает системные настройки.

Откуда брать Public ID и секрет: Быстрый старт.

Быстрая настройка уведомлений ​

В кабинете CloudPayments укажите шесть адресов. Общий вид:

text
https://ваш-домен.ru/assets/components/msp3cloudpayments/webhook.php?event=pay

Вместо pay подставьте check, fail, confirm, refund, cancel. Полный список: Быстрый старт.

JSON-адрес ядра MiniShop3 для этих уведомлений не подходит. CloudPayments шлёт обычную форму.

Архитектура ​

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

НужноДокумент
Установить и принять первый платёжБыстрый старт
Все ключи msp3cloudpayments_*Системные настройки
Уведомления, холд, чек, старый пакетИнтеграция
Код 13, код 12, холдFAQ
Оформление заказа MS3MiniShop3: заказ