Installation

How to download, install, and activate the FCHub Przelewy24 plugin on your WordPress site.

Requirements Checklist

Before you begin, confirm that your site meets these requirements:

Requirement	Details
WordPress	Version 6.5 or higher
PHP	Version 8.3 or higher
FluentCart	Installed and activated
SSL	Your site must be served over HTTPS
Przelewy24 Account	You need a merchant account at przelewy24.pl

FluentCart Must Be Active

FCHub Przelewy24 is a payment gateway extension for FluentCart. If FluentCart is not installed and activated, the plugin will display an admin error notice and the gateway will not register. Install FluentCart first.

Download

FCHub Przelewy24 is distributed as a WordPress plugin ZIP file. Download the latest release from the GitHub Releases page:

Download v1.0.3 — download fchub-p24-1.0.3.zip from the GitHub release page.

Installation Steps

Upload the Plugin

Navigate to Plugins > Add New Plugin in your WordPress admin dashboard. Click the Upload Plugin button at the top of the page.

Choose the fchub-p24.zip file you downloaded and click Install Now.

Activate the Plugin

After the upload completes, click Activate Plugin. WordPress will activate FCHub Przelewy24.

If FluentCart is not active at this point, you will see an admin notice:

FCHub - Przelewy24 requires FluentCart to be installed and activated.

Activate FluentCart first, then return to this step.

Verify Registration

Once both FluentCart and FCHub Przelewy24 are active, the gateway registers itself automatically. Navigate to FluentCart > Settings > Payment Methods and you should see Przelewy24 listed as an available payment gateway.

No additional steps are needed — the plugin hooks into FluentCart's fluent_cart/register_payment_methods action and registers itself during the normal payment method loading process.

What Happens on Activation

When the plugin activates, it:

Registers the Przelewy24 gateway with FluentCart's gateway manager
Sets up the IPN listener at ?fluent-cart=fct_payment_listener_ipn&method=przelewy24
Registers the Action Scheduler hook (fchub_p24_process_renewal) for subscription renewals
Enqueues the checkout JavaScript (przelewy24-checkout.js) that renders payment method selection on the FluentCart checkout page

All of this happens automatically through FluentCart's payment method registration system. You do not need to configure webhooks, create pages, or modify any code.

What Happens on Deactivation

When you deactivate the plugin:

All scheduled subscription renewals are unscheduled (the fchub_p24_process_renewal actions are removed from Action Scheduler)
Cached payment method lists are cleared
The gateway is no longer available at checkout

Settings Are Preserved

Deactivating the plugin does not delete your settings. If you reactivate, your Przelewy24 credentials and configuration will still be there.

What Happens on Uninstall (Deletion)

If you delete the plugin through the WordPress admin, the uninstall routine runs and cleans up:

Gateway settings are removed from FluentCart's fct_meta table
Cached payment method transients are deleted
Action Scheduler entries for fchub_p24_process_renewal are removed
Order meta keys with the _p24_ prefix are cleaned up

This is a full cleanup — no orphaned data is left behind.

If you prefer uploading via FTP/SFTP:

Extract fchub-p24.zip on your local machine
Upload the fchub-p24 folder to /wp-content/plugins/
Go to Plugins in WordPress admin and activate FCHub - Przelewy24

If you have WP-CLI access:

# Install from a local ZIP file
wp plugin install /path/to/fchub-p24.zip --activate

# Verify it's active
wp plugin list --name=fchub-p24 --fields=name,status,version

Next Steps

Configuration

Connect your Przelewy24 merchant credentials and configure payment channels.