mspPayU
Начало работы
Скачать модуль mspPayU можно в Магазине MODX Дополнений Simple Dream.
Для того, чтобы принимать оплату с помощью PayU, Вам необходимо сначала подать заявку на регистрацию в системе.
Помощь по интеграции модуля оплаты на сайт вы можете получить через службу технической поддержки либо напрямую у разработчика в Минске. Так же вы можете обращаться в техническую поддержку сервиса PayU, очень адекватные ребята. А еще у них очень хорошая документация по работе с их системой.
Настройка PayU
Важно
Для проверки механизма платежей пользуйтесь только тестовым окружением.
Базовая схема интеграции интернет-магазина с PayU
- Переход покупателя на интернет-сайт продавца, формирование «корзины покупок».
- Переход покупателя на сайт PayU для осуществления оплаты заказа.
- Нотификация системы продавца об успешной авторизации оплаты. Ответ системы продавца об успешном получении данного уведомления.
- Запрос в PayU от системы продавца на подтверждение оплаты покупателя. Ответ от PayU об успешном выполнении данного запроса.
- Выполняется в случае необходимости возврата. Запрос в PayU от системы продавца на отмену оплаты покупателя (возврат). Ответ от PayU об успешном выполнении данного запроса. (в данном модуле пока не поддерживается)
Если упростить, то схема сводится к тому, что сначала на сайте формируется LU-запрос с данными о платеже и отправляется в PayU, где он проверяется, обрабатывается и затем PayU со своей стороны пытается вызвать callback-ссылку, чтобы сообщить о результатах платежа вашему сайту.
Важным в данном случае правильно заполнить адрес страницы вашего сайта, куда должны проходить IPN-уведомления со стороны PayU. Это делается в настройках PayU в личном кабинете по ссылке https://secure.payu.ru/cpanel/ipn_settings.php.
Адрес должен быть вида http://site.ru/assets/components/minishop2/payment/payu.php?action=notify, где site.ru - адрес вашего сайта.
Установка и настройка пакета в MODX
При установке необходимо ввести реквизиты для начала работы с платежной системой PayU в MODX.
- Идентификатор мерчанта — это ID магазина (мерчанта), который было необходимо запомнить.
- Секретный ключ — выданный вам при регистрации сложный специальный ключ.
Можно пропустить этот шаг и заполнить эти данные позже в системных настройках. Так же не забудьте после установке включить метод оплаты в настройках miniShop2 и добавить его к необходимому методу доставки.
Чтобы перевести режим оплат из тестового в «боевой», измените системную настройку ms2_payment_payu_developer_mode с «Да» на «Нет».
Справочник по системным настройкам
| Ключ | Название | Значение по умолчанию | Описание |
|---|---|---|---|
| ms2_payment_payu_merchant_id | Идентификатор магазина (мерчанта) в системе PayU | Содержит уникальный идентификатор магазина (мерчанта). Данный идентификатор создается при регистрации в системе PayU и высылается в письме. | |
| ms2_payment_payu_secret_key | Секретный ключ | Последовательность случайных символов, выдается при регистрации. Участвует в формировании электронной подписи и используется для проверки платежей. | |
| ms2_payment_payu_checkout_url | Адрес для выполнения запросов | https://secure.payu.ru/order/lu.php | Адрес, куда будет отправляться пользователь для выполнения оплаты заказа. |
| ms2_payment_payu_developer_mode | Режим совершения тестовых платежей | Да | При значении "Да", все запросы оплаты будут отправляться на тестовую среду обработки платежей PayU. |
| ms2_payment_payu_currency | Валюта платежа | RUB | Буквенный трехзначный код валюты согласно ISO 4217. |
| ms2_payment_payu_language | Язык PayU | RU | Двухбуквенный код языка, на котором следует показывать сайт PayU при оплате. |
| ms2_payment_payu_success_id | Страница успешной оплаты PayU | 0 | Пользователь будет отправлен на эту страницу после завершения оплаты. Рекомендуется указать id страницы с корзиной, для вывода заказа. |
| ms2_payment_payu_failure_id | Страница отказа от оплаты PayU | 0 | Пользователь будет отправлен на эту страницу при неудачной оплате. Рекомендуется указать id страницы с корзиной, для вывода заказа |
| ms2_payment_payu_success_payment_id | Статус заказа при успешной оплате | 2 | При успешной оплате заказа ему будет установлен указанный номер статуса. Сами статусы редактируются в настройках miniShop2. |
| ms2_payment_payu_cancel_payment_id | Статус заказа при отмененной оплате | 4 | При отмене оплаты заказа ему будет установлен указанный номер статуса. Сами статусы редактируются в настройках miniShop2. |