Комиссия за наложенный платёж / скидка за предоплату для OpenCart 2.3, 3.x и 4.x

Наложенный платёж стоит магазину денег: комиссия перевозчика, обратная доставка выкупов, замороженные деньги и процент невыкупов. Комиссия за наложенный платёж / скидка за предоплату позволяет переложить эту разницу в чекаут: выбранный метод оплаты добавляет в итог отдельную строку — надбавку или скидку. Покупатель видит её ещё до подтверждения заказа, и сумма пересчитывается каждый раз, когда он переключает способ оплаты.

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

1. Вы создаёте правило: выбираете метод оплаты (например, «Оплата при доставке»), режим — надбавка или скидка, и тип суммы — фиксированная или процент от базы.
2. Задаёте границы. Для процента указываете мин и макс: 5% от 499 грн даст 30 грн, если минимум = 30; 5% от большого заказа упрётся в максимум. 0 = без ограничения.
3. Ограничиваете диапазон корзины — «от / до». Комиссия не сработает на заказах дешевле или дороже указанных сумм.
4. Выбираете налоговый класс строки, если комиссия должна облагаться НДС. Порядок сортировки строки должен быть меньше sort order итога «Налог» (обычно 5) — рекомендуемое значение 4.
5. Покупатель на чекауте выбирает способ оплаты — строка появляется или исчезает, итог пересчитывается, и то же значение записывается в заказ.
6. С Pro правил может быть сколько угодно: они проверяются по приоритету (меньше число — выше приоритет), а к условиям добавляются метод доставки, категория товара в корзине, группа покупателей и диапазон дат.

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

• Штатный механизм итогов. Это полноценное расширение типа total — строка встаёт в один ряд с «Сумма», «Доставка» и «Налог», поэтому попадает в заказ, письма и отчёты без отдельных костылей.
• Разные сигнатуры OC3 и OC4. В OpenCart 3.0.5 метод тотала принимает getTotal($total) с массивом totals / taxes / total, а в OpenCart 4 — три отдельные ссылки. Порт учитывает оба варианта, поэтому один и тот же калькулятор даёт одинаковый результат на обеих ветках.
• Нормализация кода метода оплаты. В OpenCart 3 в сессии лежит cod, в OpenCart 4 — cod.cod. Модуль сводит оба формата к базовому коду, поэтому правило, настроенное один раз, работает на любой версии.
• Налоги без сюрпризов. Строке можно назначить налоговый класс, и НДС считается именно с комиссии — при условии корректного порядка сортировки относительно итога «Налог».

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

1. OpenCart 4.x: скачайте cc_codfee.ocmod.zip, установите через «Расширения → Инсталлятор», далее «Расширения → Итоги заказа» → «Комиссия за наложенный платёж» → «Установить» → «Редактировать».
2. OpenCart 3.0.x: скачайте cc_codfee-oc3.ocmod.zip, установите через «Расширения → Установки», обновите кеш в «Расширения → Модификации», далее — «Расширения → Итоги заказа».
3. OpenCart 2.3.x: скачайте cc_codfee-oc2.ocmod.zip, распакуйте и залейте содержимое папки upload/ в корень магазина по FTP или через файловый менеджер хостинга. Штатный Инсталлятор 2.3 копирует файлы только по FTP и на большинстве хостингов не работает, поэтому установка ручная. Далее — «Расширения → Итоги заказа» → «Установить» → «Редактировать». Ядро не патчится: install.xml в архиве лишь регистрирует расширение в списке модификаций.
4. Включите статус, впишите название строки (например, «Комиссия за наложенный платёж»), выберите метод оплаты и укажите сумму или процент.
5. Проверьте, что нужный метод оплаты действительно установлен в «Расширения → Оплата» — иначе в списке его не будет.
6. Если комиссия должна облагаться НДС — выберите налоговый класс и поставьте порядок сортировки 4 (меньше sort order строки «Налог»).
7. Для Pro: нажмите «Попробовать Pro» — в окне либо берите 7-дневный триал по email, либо вставляйте купленный ключ на вкладке «У меня есть ключ». После активации в расчёте участвуют все правила, а не только базовое; срабатывает первое, подходящее по приоритету.