msp3Sberbank

Оплата через Сбербанк для MiniShop3
Документация
Документация
сбербанк оплата эквайринг minishop3 modx3 54-фз платежная система Sberbank
Иван Бочкарев
Автор дополнения
Иван Бочкарев
Пакетов
20
Закачек
129
Обычно отвечает в течение суток
Автор дополнения
Иван Бочкарев Иван Бочкарев
Пакетов
20
Закачек
129
Обычно отвечает в течение суток

ms3RecentlyViewed

Недавно просмотренные товары для MiniShop3

ms3FirstTimeBuyerDiscount

Автоматическая скидка на первый заказ пользователя

PhoneSpamDetect

валидация телефонов в формах MODX
Версия 1.0.0-beta
Дата выпуска 11.07.2026
Загрузки 0
Просмотры 9
Внимание, этот компонент требует PHP 8.2 или выше!
Внимание, этот компонент требует MODX 3 или выше.
msp3Sberbank — приём платежей через Сбербанк (Partner API v1) для MiniShop3 на MODX Revolution 3.x.

Компонент регистрирует платёж, отправляет покупателя на форму банка, принимает callback, перепроверяет статус и сумму через API, обновляет статус заказа. Поддерживает одно- и двухстадийную оплату, 54-ФЗ (orderBundle), Deposit / Reverse / Refund.

Особенности
  • рассчитан на MODX 3.0+, MiniShop3, PHP 8.2+
  • одностадийная оплата (register.do) и двухстадийная (registerPreAuth.do + Deposit / Reverse)
  • чеки 54-ФЗ через orderBundle (ФФД 1.05 / 1.2, tax_type)
  • callback с опциональным checksum HMAC-SHA256 / RSA по алгоритму Сбербанка
  • сверка суммы оплаты с заказом (±1 коп.)
  • reuse свежего form_url до session_timeout_secs, затем re-register
  • сертификаты НУЦ в пакете (обход curl error 60)
  • тестовый и боевой контур через api_url; логи при debug=1 без полного пароля

Важно до покупки
  • только MODX 3 + MiniShop3 (не miniShop2)
  • нужен договор эквайринга и логин -api (не кабинетный -operator)
  • кнопок Deposit/Refund в карточке заказа нет — вызов из кода (есть примеры в docs)
  • письма об оплате шлёт MiniShop3 по смене статуса, не сам пакет

Где взять api_login и api_password

Нужны учётные данные вашего договора. Публичные демо с developers.sber.ru часто дают errorCode 5.

В личном кабинете мерчанта (логин -operator): Настройки → API пользователи → пользователь -api → создать/сменить пароль. В MODX:


Не используйте старые URL 3dsec.sberbank.ru / securepayments.sberbank.ru.

Callback URL

В ЛК Сбербанка укажите (только HTTPS):

https://ВАШ_ДОМЕН/assets/components/msp3sberbank/callback.php

Рекомендуется подпись: токен → msp3sberbank_callback_secret или PEM публичного ключа → msp3sberbank_callback_public_key.

Настройка в MODX

После установки откройте системные настройки namespace msp3sberbank (17 ключей). Минимум: api_url, api_login, api_password. Привяжите способ оплаты «Сбербанк» или «Сбербанк (двухстадийная)» к доставкам.

Тестирование

Включите msp3sberbank_debug = 1. Тестовая карта МИР (актуальный список — в OpenAPI ecomtest): 2202 2050 0001 2424, срок 05/35, CVC 669.

Changelog

Format: Keep a Changelog

[1.0.0-beta] - 2026-07-11

Added

  • Partner API v1 — register.do / registerPreAuth.do, getOrderStatusExtended.do, deposit.do, reverse.do, refund.do
  • Оплата — одностадийная (SberbankPayment) и двухстадийная (SberbankPreAuthPayment)
  • Callback — callback.php, JSON mdOrder и legacy orderId; checksum HMAC-SHA256 / SHA512withRSA (callback_secret, callback_public_key)
  • Сверка суммы — receive() сравнивает сумму шлюза с заказом (±1 коп.)
  • formUrl — reuse до session_timeout_secs; re-register с orderNumber {id}-{attempt}
  • Чеки 54-ФЗ — orderBundle в register и deposit (ФФД 1.05 / 1.2, tax_type)
  • Процессоры — Deposit, Reverse, Refund (processors/*.class.php + src/Processors/)
  • Системные настройки — namespace msp3sberbank (17 ключей): API, статусы, callback, 54-ФЗ, TLS, debug
  • НУЦ — bundled certs/russian-trusted-chain.pem

Последние обсуждения в сообществе MODX.pro