Розробка плагіна Magento 2 для платіжного сервісу

Контекст проєкту

Потрібно оновити й зробити повністю робочим платіжний модуль Fondy для Magento 2, який зараз доступний як офіційний плагін Fondy та open‑source репозиторій на GitHub: fondy.io/gb/plugins/magento-2 та github.com/cloudipsp/magento2. Поточний модуль офіційно орієнтований на Magento 2.0–2.3, тоді як у продакшні зараз переважно використовуються гілки 2.4.x, які мають зміни в залежностях (PHP версії, payment API тощо).

Ціль таски

• Адаптувати та оновити модуль Fondy для коректної роботи на актуальних версіях Magento 2.4.x (Open Source / Commerce, уточнимо конкретний minor після старту).

• Забезпечити стабільну роботу як мінімум двох способів інтеграції:

  • redirect (Fondy hosted payment page — метод “Fondy” в адмінці).

  • embedded/on-page checkout (Fondy on Page / Fondy Checkout з ipsp-js-sdk/checkout‑скриптом).

• Підготувати зрозумілу інструкцію з встановлення, активації та налаштування модуля для Magento 2.4.x (через Composer і, за можливості, через Magento Marketplace/архів).

Поточний стан

На даний момент офіційна документація Fondy по Magento 2 описує підтримку Magento 2.0–2.2 та 2.3, включно з інсталяцією вручну та через Composer (cloudipsp/magento2:1.2.1 і dev-master). Останні релізи Magento 2.4.x змінювали підтримувані версії PHP і мають нові вимоги до модулів, що може ламати старі payment‑extensions. Точні помилки (логи, stack trace, версія Magento/PHP) будуть надані після першої спроби встановлення/активації на dev‑стенді.

Обсяг робіт

1. Аналіз та аудит існуючого модуля

• Переглянути репозиторій cloudipsp/magento2: структуру модуля, composer.json, залежності, використання payment API Magento, способи рендерінгу checkout (redirect / on-page).

• Зіставити поточну реалізацію з вимогами Magento 2.4.x (мінімальні PHP‑версії, зміни в модулях payment, event/observer, DI, layout/JS‑компонентах).

• Скласти список несумісностей та потенційних точок відмови (deprecated класи/інтерфейси, змінені XML‑конфіги, проблеми з залежностями Composer).

2. Оновлення коду модуля під Magento 2.4.x

• Оновити composer.json модуля (версії PHP, залежності, тип пакета, autoload, constraint для magento/framework і модулів payment).

• Привести module.xml, registration.php, etc/di.xml, etc/payment.xml, etc/config.xml у відповідність до вимог Magento 2.4.x.

• Перевірити та за потреби оновити JS‑частину / Knockout UI компонентів checkout (особливо для on-page інтеграції через Fondy Checkout / ipsp-js-sdk).

• Забезпечити коректну роботу основних флоу:

  • створення платіжного запиту до Fondy (merchant_id, payment_key, amount, currency, order_desc тощо).

  • обробка callback/notification (webhook) від Fondy, оновлення статусів замовлення в Magento (pending, processing, canceled, refunded тощо).

  • підтримка миттєвих повернень (refunds) та, якщо можливо, hold/capture (freezing amount, partial capture/refund).

3. Налаштування та UX в адмінці

• Переконатися, що модуль коректно з’являється в Stores → Configuration → Sales → Payment Methods → Fondy / Fondy on Page.

• Поля конфігурації:

  • Merchant ID

  • Payment Key / Secret

  • режим: test/production

  • валюти за замовчуванням, дозволені карти/методи (Card, Apple Pay, Google Pay, local methods тощо).

• Перевірити, що увімкнення/вимкнення способу платежу працює штатно і не ламає checkout при відключеному Fondy.

4. Тестування

• Налаштувати стенд Magento 2.4.x (версія буде узгоджена: наприклад, 2.4.6-pX).

• Покрити такі сценарії:

  • успішна оплата (redirect на сторінку Fondy та повернення на сайт).

  • невдала оплата / відмова банку.

  • скасування платежу користувачем на стороні Fondy.

  • повторний payment attempt для незавершеного замовлення (якщо актуально).

  • refund з адмінки Magento (якщо реалізовано в модулі).

• Надати короткий test report (список сценаріїв, результат, логи/скріни при помилках).

5. Документація

• Підготувати README/інструкцію (у вигляді Markdown‑документа) з такими розділами:

  • Вимоги: Magento 2.4.x, мінімальна версія PHP, необхідні модулі.

  • Встановлення:

    • через Composer (cloudipsp/magento2, команди composer require тощо).

    • (опційно) через завантаження архіву / Magento Marketplace, якщо це планується.

  • Активація: php bin/magento module:enable Fondy_Fondy, setup:upgrade, setup:static-content:deploy.

  • Налаштування в адмінці (Stores → Configuration → Sales → Payment Methods → Fondy), опис кожного поля.

  • Опис основних сценаріїв роботи та поради з діагностики типових помилок (де шукати логи, які статуси чекати).

Очікуваний результат

• Оновлений, встановлюваний через Composer модуль Fondy, який:

  • успішно інсталюється та активується на Magento 2.4.x без fatals та critical warnings.

  • дозволяє проводити реальні/тестові оплати через Fondy (redirect та, по можливості, on-page).

  • коректно обробляє webhooks та змінює статуси замовлень у Magento.

• Репозиторій (fork або окремий репо) з:

  • вихідним кодом модуля,

  • інструкцією по встановленню/налаштуванню,

  • коротким описом виконаних змін (changelog).

Що потрібно від фрілансера

• Досвід розробки/підтримки payment‑модулів під Magento 2 (бажано кейси саме з 2.4.x).

• Досвід роботи з Composer‑пакетами, Magento DI, payment gateways та, бажано, з Fondy або подібними системами.

• Готовність коротко документувати зміни й надати basic support по інтеграції (відповіді на питання по установці/конфігурації).