docs.modx.pro
msp3CDEKPay
Приём оплаты через CDEK Pay для MiniShop3: ссылка, QR СБП, webhook и чеки
  • MODX 3
  • PHP 8.2
  • miniShop3
Зависимости
  • miniShop3
  1. Компоненты
  2. msp3CDEKPay

msp3CDEKPay ​

msp3CDEKPay подключает CDEK Pay к MiniShop3 в MODX Revolution 3. Покупатель переходит по ссылке или открывает QR СБП. Статус «оплачен» выставляет MiniShop3, когда приходит уведомление. Пакет сам статус заказа не меняет. Письма покупателю шлёт Центр уведомлений MiniShop3.

В заказе сумма в рублях. В CDEK Pay пакет отправляет её в копейках. Боевая валюта в запросе RUR, тестовая TST. Код RUB пакет не передаёт.

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

Подпись уведомления считается секретным ключом магазина. Для валюты RUR это боевой секрет, для TST тестовый.

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

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

  • Оплата по ссылке: способ Оплата через CDEK Pay.
  • QR СБП: способ Оплата через CDEK Pay (СБП QR).
  • Один адрес уведомлений в кабинете. Пакет ищет попытку по ключу ссылки среди обоих способов.
  • Чек 54-ФЗ уходит вместе с заказом на оплату, если включена настройка и в кабинете есть касса. Нужен email покупателя.
  • Во вкладке заказа: попытки, возврат, блокировка ссылки, синхронизация, чек полного расчёта, коррекция.
  • Привязка карты и счёта СБП сниппетами. Расписания списаний в пакете нет.

Выплата наложенного платежа статус заказа не меняет.

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

ТребованиеВерсия
MODX Revolution3.0+
MiniShop31.14.0-beta1 и новее
PHP8.2+
pdoTools 3.xтолько если сниппету cdekPayBindings задан чанк
Доступлогин магазина, боевой и тестовый секреты
СайтHTTPS на webhook без 301

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

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

Установка ​

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

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

НазваниеКласс
Оплата через CDEK PayMsp3CDEKPay\Payment\CdekPayPayment
Оплата через CDEK Pay (СБП QR)Msp3CDEKPay\Payment\CdekPaySbpPayment

Логин и секреты пакет читает из системных настроек. В свойства способа оплаты их класть не нужно.

Откуда брать логин и секреты: Быстрый старт.

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

В кабинете CDEK Pay откройте Интеграция → Настройка API и укажите:

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

HTTPS без 301. Уведомление приходит JSON-объектом. Обычная форма не подойдёт.

Для одного способа можно прописать адрес ядра MiniShop3. Для магазина удобнее один пакетный URL. Подробнее: Интеграция.

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

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

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