Оплата через 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».