Opracowanie wtyczki Magento 2 dla usługi płatniczej

Project Context

It is necessary to update and make the Fondy payment module for Magento 2 fully operational, which is currently available as an official Fondy plugin and open-source repository on GitHub: fondy.io/gb/plugins/magento-2 and github.com/cloudipsp/magento2. The current module is officially targeted at Magento 2.0–2.3, while in production, branches 2.4.x are predominantly used, which have changes in dependencies (PHP versions, payment API, etc.).

Task Objective

• Adapt and update the Fondy module for correct operation on the current versions of Magento 2.4.x (Open Source / Commerce, we will specify the specific minor version after the start).

• Ensure stable operation of at least two integration methods:

  • redirect (Fondy hosted payment page — the “Fondy” method in the admin panel).

  • embedded/on-page checkout (Fondy on Page / Fondy Checkout with ipsp-js-sdk/checkout script).

• Prepare a clear installation, activation, and configuration guide for the module for Magento 2.4.x (via Composer and, if possible, via Magento Marketplace/archive).

Current Status

Currently, the official Fondy documentation for Magento 2 describes support for Magento 2.0–2.2 and 2.3, including manual installation and via Composer (cloudipsp/magento2:1.2.1 and dev-master). The latest releases of Magento 2.4.x have changed the supported PHP versions and have new requirements for modules, which may break old payment extensions. Exact errors (logs, stack trace, Magento/PHP version) will be provided after the first installation/activation attempt on the dev stand.

Scope of Work

1. Analysis and Audit of the Existing Module

• Review the cloudipsp/magento2 repository: module structure, composer.json, dependencies, use of Magento payment API, checkout rendering methods (redirect / on-page).

• Match the current implementation with the requirements of Magento 2.4.x (minimum PHP versions, changes in payment modules, event/observer, DI, layout/JS components).

• Compile a list of incompatibilities and potential points of failure (deprecated classes/interfaces, changed XML configs, Composer dependency issues).

2. Updating the Module Code for Magento 2.4.x

• Update the module's composer.json (PHP versions, dependencies, package type, autoload, constraint for magento/framework and payment modules).

• Align module.xml, registration.php, etc/di.xml, etc/payment.xml, etc/config.xml with the requirements of Magento 2.4.x.

• Check and update the JS part / Knockout UI components of checkout if necessary (especially for on-page integration via Fondy Checkout / ipsp-js-sdk).

• Ensure correct operation of the main flows:

  • creating a payment request to Fondy (merchant_id, payment_key, amount, currency, order_desc, etc.).

  • processing callback/notification (webhook) from Fondy, updating order statuses in Magento (pending, processing, canceled, refunded, etc.).

  • support for instant refunds and, if possible, hold/capture (freezing amount, partial capture/refund).

3. Configuration and UX in the Admin Panel

• Ensure that the module correctly appears in Stores → Configuration → Sales → Payment Methods → Fondy / Fondy on Page.

• Configuration fields:

  • Merchant ID

  • Payment Key / Secret

  • mode: test/production

  • default currencies, allowed cards/methods (Card, Apple Pay, Google Pay, local methods, etc.).

• Check that enabling/disabling the payment method works as expected and does not break checkout when Fondy is disabled.

4. Testing

• Set up a Magento 2.4.x stand (the version will be agreed upon: for example, 2.4.6-pX).

• Cover the following scenarios:

  • successful payment (redirect to the Fondy page and return to the site).

  • failed payment / bank denial.

  • payment cancellation by the user on the Fondy side.

  • retry payment attempt for an incomplete order (if applicable).

  • refund from the Magento admin panel (if implemented in the module).

• Provide a brief test report (list of scenarios, results, logs/screenshots in case of errors).

5. Documentation

• Prepare a README/instruction (in the form of a Markdown document) with the following sections:

  • Requirements: Magento 2.4.x, minimum PHP version, required modules.

  • Installation:

    • via Composer (cloudipsp/magento2, composer require commands, etc.).

    • (optionally) via uploading an archive / Magento Marketplace, if planned.

  • Activation: php bin/magento module:enable Fondy_Fondy, setup:upgrade, setup:static-content:deploy.

  • Configuration in the admin panel (Stores → Configuration → Sales → Payment Methods → Fondy), description of each field.

  • Description of main operation scenarios and tips for diagnosing typical errors (where to look for logs, what statuses to expect).

Expected Result

• Updated Fondy module, installable via Composer, which:

  • successfully installs and activates on Magento 2.4.x without fatals and critical warnings.

  • allows real/test payments through Fondy (redirect and, if possible, on-page).

  • correctly processes webhooks and changes order statuses in Magento.

• Repository (fork or separate repo) with:

  • module source code,

  • installation/configuration instructions,

  • brief description of changes made (changelog).

What is Required from the Freelancer

• Experience in developing/supporting payment modules for Magento 2 (preferably cases specifically with 2.4.x).

• Experience working with Composer packages, Magento DI, payment gateways, and preferably with Fondy or similar systems.

• Willingness to briefly document changes and provide basic support for integration (answers to installation/configuration questions).