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 днів тріалу вгорі сторінки налаштувань.