Оплата через CM.com для OpenCart — iDEAL | Wero, картки, Bancontact (Нідерланди)

Payments with CM.com for OpenCart (OpenCart 4.x, 3.x і 2.3) приймає платежі магазину через нідерландський платіжний сервіс CM.com (Online Payments): покупець переходить на захищену сторінку CM.com, платить iDEAL | Wero, карткою, Bancontact, Apple Pay, Google Pay чи іншим способом, увімкненим у вашому акаунті CM.com, і повертається в магазин. Замовлення підтверджується за власним статусом транзакції в CM.com, а адмін бачить транзакції й дії просто в замовленні.

Що потрібно від CM.com. Власний акаунт мерчанта CM.com Online Payments і його облікові дані: Client ID та Client Secret. Тестове середовище з обліковими даними налаштовує підтримка CM.com. Методи оплати, які бачить покупець на сторінці CM.com, вмикаються у вашому акаунті CM.com, комісії за платежі бере CM.com за вашим тарифом.

Що отримує покупець

На кроці оплати покупець бачить метод «iDEAL | Wero, card and more (CM.com)» і пояснення, що спосіб оплати він обере на захищеній сторінці CM.com. Після оформлення він переходить на сторінку CM.com, платить і повертається в магазин. У Pro кожен спосіб може бути окремим варіантом на касі (iDEAL | Wero, картка, Bancontact, Klarna, in3…) у порядку, який ви задали: тоді сторінка CM.com відкривається вже з обраним способом. У OpenCart 4 це варіанти в кроці вибору оплати, в OpenCart 3 і 2.3 — вибір у блоці оплати.

Якщо оплату скасовано, час вийшов або платіж не пройшов, покупець бачить сторінку з причиною й кнопкою «Back to checkout»: замовлення лишається неоформленим, кошик на місці, оплатити можна повторно. Сторінка CM.com відкривається мовою магазину (нідерландська чи англійська), номер замовлення з вашим префіксом передається в CM.com як референс платежу. Для Klarna і in3 модуль передає позиції замовлення так, що їхня сума точно дорівнює сумі замовлення (ПДВ товарів, окремий рядок доставки зі своїм ПДВ, знижка розподілена по товарах); in3 доступний від 50 EUR і лише в євро.

Що отримує адмін

Extensions → Extensions → Payments → Payments with CM.com by CatCode: вкладки «Connection», «Checkout», «Order statuses» і «Pro». У «Connection» ви вибираєте тестове чи бойове середовище, вставляєте Client ID і Client Secret та натискаєте «Check connection»: модуль повідомляє, чи CM.com прийняв дані. Secret зберігається зашифрованим і назад у форму не повертається.

У «Checkout» — назви й описи методу для кожної мови, мінімальна сума замовлення, геозона, префікс номера замовлення для CM.com. У «Order statuses» — статуси «Paid», «Authorized», «Needs checking», «Failed after authorization», «Cancelled after authorization» і «Refunded in full». Журнал налагодження маскує дані покупця.

У замовленні зʼявляється вкладка з транзакціями CM.com: дата, транзакція, метод, сума й статус. Кнопка «Check status at CM.com» перечитує статус транзакції. Якщо одне замовлення оплатили двічі або прийшов чарджбек, модуль залишає про це нотатку в замовленні.

Що додає Pro

У Pro метод на касі можна розбити на окремі: iDEAL | Wero, картка, Bancontact, Apple Pay, Google Pay, Klarna, in3. Для кожного ви вмикаєте «окремо на касі», задаєте порядок і вирішуєте, чи лишати загальну опцію CM.com поруч. Для загальної сторінки CM.com можна обрати підмножину способів; час на оплату задається в межах 5–60 хвилин.

Повернення коштів — зі сторінки замовлення: повне чи часткове, з причиною. CM.com повідомляє результат кожного повернення вебхуком (виплачено, не вдалося, скасовано), і замовлення отримує нотатку; повне повернення переводить замовлення в статус «повернено». Раз на годину модуль перепитує CM.com про відкриті платежі й повернення (в OpenCart 4 — через власний планувальник, в 3.x і 2.3 — за адресою для серверного cron) і підтверджує оплату, чий вебхук загубився. Кнопка «Check open payments now» робить це вручну.

Журнал платежів показує платежі із замовленням, методом, поверненнями й статусом, попереджає, якщо сума в CM.com відрізняється від суми замовлення, і зберігає лог запитів до CM.com 30 днів без облікових даних і даних покупця.

Як це працює, крок за кроком

1. Встановіть архів для вашої версії OpenCart і встановіть розширення в Extensions → Extensions → Payments.
2. У CM.com отримайте Client ID і Client Secret вашого акаунта (для тесту — тестові дані від підтримки CM.com).
3. У вкладці «Connection» оберіть середовище, вставте дані й натисніть «Check connection».
4. У «Checkout» задайте назву, мінімальну суму й геозону, у «Order statuses» — статуси, збережіть.
5. Оформіть пробне замовлення в євро: на кроці оплати оберіть CM.com, оплатіть на сторінці CM.com.
6. Відкрийте замовлення в адмінці: у вкладці CM.com видно транзакцію зі статусом.

Що під капотом

• CM.com Online Payments API v1: OAuth 2.0 (client credentials), Create Transaction, Get Transaction, Create a Refund, список повернень, вебхуки FINALSTATUS, STATUS_CHANGE і REFUND_STATUS. Тестове середовище pay-acceptance.cm.com, бойове — pay.cm.com.
• Замовлення оплачується лише після Get Transaction: вебхук, повернення покупця й сторінка результату читають статус із CM.com; сума, валюта й сума замовлення порівнюються до позначки «оплачено».
• Адреса покупця передається з розбором номера будинку (наприклад, 25a) і поштового індексу без пробілу.
• Для OpenCart 4 перевірка відкритих платежів іде через планувальник OpenCart (System → Maintenance → Cron jobs), для 3.x і 2.3 — за адресою з секретним ключем.
• Налаштування лишаються після повторного встановлення модуля.
• Інтерфейс англійською та нідерландською.

Як встановити

1. Extensions → Installer: завантажте архів для вашої версії без перейменування (OpenCart 4: cc_cmcom.ocmod.zip, 3.x: cc_cmcom-oc3.ocmod.zip, 2.3: cc_cmcom-oc2.ocmod.zip).
2. Для 3.x і 2.3: Extensions → Modifications → Refresh.
3. Extensions → Extensions → Payments → Payments with CM.com by CatCode: встановіть розширення й відкрийте налаштування.
4. У «Connection» оберіть середовище, вставте Client ID і Client Secret, натисніть «Check connection».
5. У «Checkout» і «Order statuses» задайте назву, суму, геозону й статуси; збережіть і ввімкніть метод.
6. Для Pro: введіть ключ або запустіть пробний період у вкладці «Pro».