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.