Configuration

Where to Find Settings

The Przelewy24 configuration lives inside FluentCart's payment settings:

FluentCart > Settings > Payment Methods > Przelewy24

Click the Przelewy24 card to open the configuration panel. All settings are saved through FluentCart's standard settings interface.

Credentials

Przelewy24 requires four credentials to process payments. You will need separate sets for sandbox (test) and live (production) environments.

Finding Your Credentials in the P24 Panel

Connection Verification

When you save the settings, the plugin automatically calls the Przelewy24 testAccess API endpoint. If the connection succeeds, you will see:

Przelewy24 connection verified!

If it fails, you will see the specific error from the API. Common causes:

• Incorrect API Key or CRC Key
• Using sandbox credentials with FluentCart in live mode (or vice versa)
• Merchant account not fully activated on the P24 side

Store Mode

Payment Channels

Payment channels control which payment methods are offered to your customers. Each channel is a toggle that maps to a Przelewy24 channel bitmask flag:

The plugin combines the enabled channels into a single bitmask integer and sends it with each transaction registration. If no channels are explicitly enabled, the plugin defaults to bitmask 63 (all basic channels).

Payment Time Limit

The Payment time limit setting controls how long a customer has to complete their payment on the Przelewy24 page before the session expires. Available options:

• No limit (0)
• 5 minutes
• 10 minutes
• 15 minutes (default)
• 30 minutes
• 60 minutes

This value is sent as timeLimit in the transaction registration request.

Card Recurring Payments

The Card recurring payments toggle enables subscription billing via card-on-file. When enabled:

• The subscription module registers with FluentCart
• Initial subscription payments force the cards channel (bitmask 1) so Przelewy24 tokenizes the card
• After successful payment, the plugin fetches and stores the card reference ID (refId) for future charges

When disabled, the subscription module is not loaded, and FluentCart won't offer recurring billing through Przelewy24.

Webhook URL (IPN)

The plugin automatically sends the webhook URL with every transaction registration. The URL follows this format:

https://yoursite.com/?fluent-cart=fct_payment_listener_ipn&method=przelewy24

This URL is generated by FluentCart's PaymentHelper class and sent as the urlStatus parameter. You do not need to configure this URL manually in the Przelewy24 panel — the plugin includes it in every API call.

The webhook URL is displayed in the Przelewy24 settings panel in FluentCart for your reference.

Hardcoding Credentials via wp-config.php

For security or deployment automation, you can define credentials as PHP constants in your wp-config.php file. When constants are defined, they take priority over database-stored values.

define('FCHUB_P24_LIVE_MERCHANT_ID', '123456');
define('FCHUB_P24_LIVE_SHOP_ID', '123456');
define('FCHUB_P24_LIVE_CRC_KEY', 'your-live-crc-key');
define('FCHUB_P24_LIVE_API_KEY', 'your-live-api-key');

define('FCHUB_P24_TEST_MERCHANT_ID', '123456');
define('FCHUB_P24_TEST_SHOP_ID', '123456');
define('FCHUB_P24_TEST_CRC_KEY', 'your-test-crc-key');
define('FCHUB_P24_TEST_API_KEY', 'your-test-api-key');

define('FCHUB_P24_LIVE_MERCHANT_ID', getenv('P24_MERCHANT_ID'));
define('FCHUB_P24_LIVE_CRC_KEY', getenv('P24_CRC_KEY'));
define('FCHUB_P24_LIVE_API_KEY', getenv('P24_API_KEY'));

Full Constants Reference

Next Steps