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

msp3AlfaBank ​

msp3AlfaBank подключает интернет-эквайринг Альфа-Банка к MiniShop3 в MODX Revolution 3. Статус «оплачен» выставляет MiniShop3. Пакет сам статус заказа не меняет. Письма покупателю шлёт Центр уведомлений MiniShop3.

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

В заказе сумма в рублях. В банк пакет отправляет её в копейках. Отдельной подписи у колбэка нет: пакет сверяет логин с паролем и сумму с попыткой оплаты.

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

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

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

Публичного демо-кабинета у банка нет. Логин и пароль приходят в письме.

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

ТребованиеВерсия
MODX Revolution3.0+
MiniShop31.14.0-beta1 и новее
PHP8.2+
Доступлогин с суффиксом -api и пароль из письма банка
СайтHTTPS на webhook без 301

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

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

Установка ​

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

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

НазваниеКласс
Оплата через Альфа-БанкMsp3AlfaBank\Payment\AlfaBankPayment
Оплата через Альфа-Банк (двухстадийная)Msp3AlfaBank\Payment\AlfaBankTwoStagePayment

Логин и пароль положите в msPayment.properties (user_name или login, password или secret). Если properties пусты, пакет читает системные настройки.

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

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

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

Пакет сам передаёт адрес колбэка при создании платежа. В кабинете банка укажите тот же URL:

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

HTTPS без 301. JSON-адрес ядра MiniShop3 для колбэка Альфа-Банка не подходит.

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

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

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