Комісія за післяплату / знижка за передоплату для 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, або вставляйте куплений ключ на вкладці «У мене є ключ». Після активації в розрахунку беруть участь усі правила, а не тільки базове; спрацьовує перше, що підходить за пріоритетом.