Up2Pay, Monetico и Systempay для OpenCart 2.3, 3.x и 4.x — оплата картой через французские банки

Up2Pay, Monetico & Systempay — модуль оплаты OpenCart для трёх французских банковских шлюзов: Up2Pay e-Transactions (Crédit Agricole), Monetico (Crédit Mutuel и CIC) и Systempay (Banque Populaire и Caisse d’Epargne). Покупатель платит картой на защищённой странице банка с 3-D Secure, а заказ становится оплаченным только после подписанного ответа банка.

Что видит покупатель

Покупатель выбирает «Bank card» нужного банка, на шаге подтверждения видит сумму и кнопку «Pay by card» и переходит на страницу банка. После оплаты возвращается в магазин; если подтверждение банка ещё не пришло, страница пишет, что ждёт, и переходит дальше сама. Отказ или отмена не закрывают заказ: покупатель видит причину от банка на своём языке, корзина остаётся, оплату можно повторить.

Что получает админ

Расширения → Оплаты → Up2Pay, Monetico & Systempay: основной банк, среда Test или Production, вкладка для каждого банка с данными из договора и ключами, валюта договора (заказы в другой валюте магазина пересчитываются по курсу магазина), статусы заказа и геозона. Кнопки «Check» для каждого банка проверяют данные без движения денег; для Up2Pay есть кнопка, которая подставляет публичный демо-магазин Crédit Agricole.

В заказе есть вкладка с платежом: сумма, банк, референс, транзакция, карта, все попытки оплаты. В Pro оттуда же делается полный или частичный возврат в банк; если ответ банка потерялся, следующие возвраты блокируются, пока вы не сверите бэк-офис банка. Журнал платежей показывает все оплаты и возвраты трёх банков.

Как это работает, шаг за шагом

1. Выбираете основной банк и вносите на его вкладке данные из договора и ключи.
2. Systempay: копируете адрес IPN из настроек в бэк-офис банка. Up2Pay и Monetico получают адрес уведомлений с каждым платежом.
3. Покупатель подтверждает заказ, модуль отправляет его на страницу банка с подписанной формой.
4. Банк сообщает магазину результат; модуль проверяет подпись, сумму, валюту и корзину и только тогда ставит статус «оплачено». Расхождение — отдельный статус для проверки.
5. В Pro покупатель выбирает один из двух-трёх банков, а возврат делается со страницы заказа.

Что под капотом

• Up2Pay: форма с HMAC, возврат покупателя и уведомление проверяются публичным ключом RSA банка.
• Monetico: MAC в форме и в ответе «Retour», контекст заказа для 3-D Secure.
• Systempay: подпись vads_* (HMAC-SHA-256 или SHA-1) в форме, IPN и возврате покупателя.
• Заказ не оплачивается дважды: одна оплата — одна запись в истории.
• Адреса возврата короткие, потому что банки ограничивают длину; слишком длинный адрес модуль не отправляет и предупреждает в настройках.
• Ключи хранятся зашифрованными; журнал отладки без ключей и данных карты.

Как установить

1. Расширения → Установщик: загрузите архив под свою версию, не меняя имя файла.
2. OpenCart 3.x и 2.3: Расширения → Модификации → «Обновить».
3. Расширения → Оплаты → Up2Pay, Monetico & Systempay → установить → редактировать.
4. Выберите основной банк, внесите на его вкладке данные и ключи, сохраните и нажмите «Check».
5. Systempay: скопируйте адрес IPN в бэк-офис. Потом одна оплата тестовой картой банка в среде Test и переключение на Production.
6. Для Pro: вставьте ключ или запустите 7 дней триала вверху страницы настроек.