pistol88/yii2-paymaster

Payment widget for paymaster.ru

Yii2-paymaster

В составе модуля содержится виджет оплаты заказа через paymaster.ru. В виджет передается модель заказа, которая должна имплементировать интерфейс interfaces/Order., _(*1)

Модуль написан в основном для pistol88/yii2-order, но подойдет для любого сайта, где есть модель заказа., _(*2)

Установка

Выполнить команду, _(*3)

php composer require pistol88/yii2-paymaster "*"

Или добавить в composer.json, _(*4)

"pistol88/yii2-paymaster": "*",

И выполнить, _(*5)

php composer update

Подключение и настройка

В конфигурационный файл приложения добавить модуль paymaster, _(*6)

    'modules' => [
        'paymaster' => [
            'class' => 'pistol88\paymaster\Module',
            'merchantId' => 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', //Идентификатор мерчанта, выдается автоматически в личном кабинете
            'secret' => 'XXXXXX', //Секретный ключ, задается вручную в настройках магазина
            'thanksUrl' => '/page/spasibo-za-zakaz', //Страница, куда попадает пользователь после оплаты. Туда ГЕТ параметром будет передан также номер заказа.
            'failUrl' => '/page/problema-s-oplatoy', //Страница, куда попадает пользовать в случае неудачной оплаты.
            'currency' => 'RUB', //Яснопонятно
            'orderModel' => 'pistol88\order\models\Order', //Модель заказа. Эта модель должна имплементировать интерфейс pistol88\paymaster\interfaces\Order. В момент списания денег будет вызываться $model->setPaymentStatus('yes').
        ],
        //...
    ],

Чтобы срабатывал редирект обратно и оповещение сайта о списании денег, не забудьте поставить галочку "Разрешена замена URL" в настройках магазина в кабинете Паймастера., _(*7)

Виджеты

За вывод формы оплаты отвечает виджет pistol88\paymaster\widgets\PaymentForm., _(*8)

Скорее всего, самое уместное место для виджета - страница "спасибо за заказ., _(*9)

<?=\pistol88\paymaster\widgets\PaymentForm::widget([
    'autoSend' => false,
    'orderModel' => $model,
    'description' => 'Оплата заказа'
]);?>

• autoSend - нужно ли автоматически отправлять форму заказа
• orderModel - экземпляр модели заказа, имплементирующий interfaces/Order
• description - описание платежа