Younited Pay для OpenCart — оплата частинами для Франції

Younited Pay для OpenCart 4.x, 3.x і 2.3 додає на чекаут спосіб оплати «Payer en plusieurs fois avec Younited Pay»: покупець обирає один із планів, які Younited пропонує для суми його замовлення (розділення на 2–4 платежі, кредит на кілька місяців), і оформлює заявку на захищеній сторінці Younited. Модуль працює з вашим мерчант-акаунтом Younited напряму, без посередника. Інтерфейс модуля — французька й англійська.

Що потрібно від Younited. Договір мерчанта з Younited і дані з порталу Younited Pay: Client ID, Client secret і Shop code (код інтернет-магазину). Умови, ліміти й вартість для покупця визначає Younited. Модуль працює в євро: магазин має мати валюту EUR.

Що бачить покупець

На чекауті покупець обирає «Payer en plusieurs fois avec Younited Pay». Під методом показано плани, які Younited повернув саме для суми цього замовлення, наприклад «3 fois», «4 fois» або «10 mensualités»: внесок, «Montant total dû», вартість і TAEG для кожного плану — це цифри Younited, модуль їх не обчислює. Нижче стоїть нагадування, що кредит зобов’язує й треба оцінити свої можливості повернення. Після кнопки «Continuer vers Younited Pay» покупець потрапляє на сторінку Younited, подає заявку й повертається в магазин. Якщо він скасував заявку або Younited її не прийняв, покупець бачить зрозумілу сторінку з кнопкою «Payer autrement», і товари повертаються в кошик, включно з опціями. Якщо відповідь Younited ще не дійшла, замовлення підтвердиться, щойно сповіщення прийде.

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

Extensions → Extensions → Payments → Younited Pay by CatCode: вкладки «Général», «Commande», «Statuts de commande», «Notifications» і «Pro». На «Général» вписуєте Client ID, Client secret і Shop code, обираєте sandbox або production. Client secret зберігається в базі зашифрованим і назад не показується. Кнопка «Vérifier la connexion» отримує токен, показує магазини вашого акаунта й каже, чи є серед них ваш Shop code.

На вкладці «Commande» задаються назва й текст методу для кожної мови, мінімальна й максимальна сума замовлення в євро, геозона й сортування, а також момент розміщення замовлення: при переході на Younited (статус на ваш вибір) або лише після схвалення заявки. Плани, які бачить покупець, беруться з пропозиції Younited для його суми; у налаштуваннях можна залишити лише потрібні варіанти кількості платежів.

Статуси замовлення змінюються за сповіщеннями Younited: схвалено, прийнято, виконано, невдача, скасовано, повністю повернено. Сповіщення підписані (HMAC-SHA256 з ключем із вкладки «Notifications»), і модуль у будь-якому разі спершу читає платіж у Younited й лише потім змінює замовлення; в історії на кожну зміну один рядок. Якщо виконана сума не збігається з сумою замовлення, замовлення не стає оплаченим, а позначається для розгляду. Адреса сповіщень передається з кожним платежем, її не треба вписувати в портал. Кнопка «Envoyer une notification de test» просить Younited викликати магазин і показує відповідь; останнє сповіщення видно на сторінці налаштувань.

Прийнятий кредит у безкоштовній версії виконується одразу автоматично, тож гроші надходять без жодного кліку; розділення на кілька платежів (split) Younited виконує сам. Pro дає вибір: виконувати кредит лише тоді, коли замовлення отримує потрібні статуси (наприклад «Expédiée»), а також кнопки «Exécuter», «Annuler le paiement» і «Rembourser» (повне або часткове повернення) на сторінці замовлення. Окремий статус призначається повністю поверненим замовленням, а платіж у Younited можна скасовувати за вибраними статусами замовлення.

Рядок розстрочки (Pro) на сторінці товару й у кошику: «ou 10 fois …» із загальною сумою й TAEG, які повертає Younited для вашого договору (кеш 6 годин). Журнал платежів з фільтром за станом і датами, підсумками «виконано/повернено» та експортом CSV. Щогодинна звірка платежів, про які немає новин, працює з планувальником OpenCart 4 або з cron-адреси на хостингу для 3.x і 2.3. Окремо задаються виключення товарів і категорій та Shop code на кожен магазин мультистору.

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

1. Встановлюєте архів для своєї версії OpenCart і вмикаєте модуль.
2. У порталі Younited Pay беретеся за Client ID, Client secret і Shop code вашого магазину.
3. У налаштуваннях модуля вписуєте їх, обираєте sandbox або production й натискаєте «Vérifier la connexion».
4. Покупець обирає «Payer en plusieurs fois avec Younited Pay», вибирає план і переходить на сторінку Younited.
5. Younited схвалює заявку; модуль читає платіж у Younited й ставить статус замовлення, а прийнятий кредит виконує сам.
6. У Pro вмикаєте виконання при статусі, повернення з замовлення, рядок розстрочки на товарах і журнал платежів.

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

• Younited Pay API 2026-02-01: токен OAuth2, пропозиція планів (payments/options), створення платежу, читання платежу, виконання, скасування й повернення; платіж іде з товарами, доставкою, знижками, контактами й адресами покупця.
• Сповіщення Younited підписані HMAC-SHA256; підпис рахується з ключем із порталу. Кожне сповіщення лише привід перечитати платіж: статус замовлення ставиться за відповіддю API.
• Client secret і ключ сповіщень зберігаються зашифрованими; журнал модуля не містить імені, e-mail, телефону й адреси покупця.
• Суми приймаються й повертаються в євро, десятковими; вартість, TAEG і загальна сума плану належать Younited.
• Нагадування про кредит під планами показується покупцю разом з даними плану; його текст стандартний і не замінює консультацію юриста.
• Модуль не змінює ядро, працює через події OpenCart; оновлення зберігає налаштування, секрети, ліцензію й платежі.
• Не входять: договір із Younited і доступ до його порталу; режим MANUAL для split (такий платіж виконує кнопка «Exécuter» у Pro).
• Інтерфейс: français і English.

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

1. Extensions → Installer: завантажте архів для своєї версії, не перейменовуючи (OpenCart 4: cc_younited.ocmod.zip, 3.x: cc_younited-oc3.ocmod.zip, 2.3: cc_younited-oc2.ocmod.zip).
2. Для 3.x і 2.3: Extensions → Modifications → Refresh.
3. Extensions → Payments → Younited Pay by CatCode: встановіть і відкрийте налаштування.
4. Впишіть Client ID, Client secret і Shop code, оберіть середовище, натисніть «Vérifier la connexion».
5. Вставте ключ сповіщень із порталу Younited на вкладці «Notifications».
6. Для Pro: вставте ключ або запустіть тріал на вкладці Pro.