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

msp3PayKeeper ​

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

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

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

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

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

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

ТребованиеВерсия
MODX Revolution3.x
MiniShop31.14.0-beta1 и новее
PHP8.2+
Чек 54-ФЗв заказе должен быть email
СайтHTTPS на webhook без 301

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

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

Установка ​

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

Резолвер создаёт два способа оплаты. Секреты сначала берутся из msPayment.properties, иначе из системных настроек.

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

Четыре значения для приёма оплаты:

  • server_url. Адрес вашего кабинета PayKeeper без / в конце. Демо-стенд: https://demo.paykeeper.ru. Адрес https://demo.server.paykeeper.ru с парой demo / demo токен не отдаёт.
  • Логин и пароль API. Это логин и пароль пользователя кабинета. Для JSON API PayKeeper советует отдельного пользователя: Настройки → Доступ к панели администратора. Проверка: GET {server_url}/info/settings/token/ с Basic Auth возвращает JSON с token.
  • Секретное слово. Это не пароль API. Настройки → Получение информации о платежах: способ уведомлений POST-оповещения, URL webhook.php, затем сгенерируйте или впишите слово.

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

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

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

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

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

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

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

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