skip to content

ecommerce 13 min read

Przelewy24 and WooCommerce: integration and setup step by step

Przelewy24 for WooCommerce, set up step by step: the account and keys, the sandbox, common errors and fees in practice. See how to connect payments without stress.

Przelewy24 and WooCommerce: integration and setup step by step

The Przelewy24 WooCommerce integration connects your shop to Przelewy24 (a Polish payment gateway): the customer pays with BLIK (the Polish mobile payment system), a fast bank transfer or a card, and WooCommerce receives confirmation of the transaction and updates the order status itself.

Well configured payments cut the time spent running the shop. You do not have to check transfers by hand or change order statuses one by one. All transactions go to the Przelewy24 panel, where you keep an eye on incoming payments, settlements and refunds.

How the Przelewy24 WooCommerce integration works

How the Przelewy24 WooCommerce integration works

Image generated by AI

The official plugin connects WooCommerce to the Przelewy24 system. The customer chooses a payment method and completes the transaction, and information about the result comes back to the shop.

In the checkout, the page where the order is placed, you can offer BLIK, fast bank transfers, cards, digital wallets and instalments, among others. The exact list depends on the methods active on your Przelewy24 account, the order currency and the plugin settings.

Some payments can take place directly in the shop. That applies to selected BLIK variants and card payments, for instance. With the other methods the customer goes to the operator’s payment page, chooses a bank or a way to pay, and then returns to the order summary page.

After a successful transaction Przelewy24 sends WooCommerce a separate confirmation. The shop marks the order as paid and moves on to fulfilment. If the customer abandons the payment or the bank rejects it, the order stays unpaid.

You get access to the transaction history, reports, balance and settlements in the Przelewy24 panel. From the same place you can issue full and partial refunds. With the API key configured correctly, some of these operations can also be done from the order in WooCommerce.

Before you start: a Przelewy24 account and the shop’s details

Before you start: a Przelewy24 account and the shop's details

Image generated by AI

First open a merchant account with Przelewy24 and go through the company verification. For the shop setup, have the merchant ID, the CRC key and the API key ready.

During registration you give the company details, the account for payouts and the shop’s address. The operator may ask for a verification transfer and documents relating to the business. It will also check the shop itself, so the basket and the checkout should be working before you apply. The site should have terms and conditions, a privacy policy, the seller’s details, delivery information and the returns policy. If you are only just building the shop, go through my guide on how to start an online store on WordPress first. Verification is easier to pass with a complete site.

You receive the merchant ID after registering. You will find the CRC key and the API key in the account settings, in the section with API details and configuration. The API key is sometimes described as the key for reports. What each detail means and the full description of the connection are in the Przelewy24 technical documentation.

Each of these elements has a different job: the ID points to the right account, the CRC key lets you check that the transaction data arrived unchanged, and the API key gives the plugin access to extra operations, for example fetching payment methods or handling refunds.

Copy the details without spaces at the start and the end. One extra character is enough for the connection test to end in an error.

Check the shop address saved in the Przelewy24 panel too. It should match the address customers use, including the HTTPS protocol and the right version of the domain. If the shop runs at an address with “www”, give exactly that variant. Access to the API services may also require the server’s IP address.

Setting up Przelewy24 in WooCommerce step by step

The setup covers installing the official plugin, entering the account details and switching on the methods you want. At the end you need to place a trial order and check the whole process from the basket to the status change.

Step 1. Install the official Przelewy24 plugin

You can download the current Przelewy24 WooCommerce module from the operator’s official site. Choose the version meant for the WooCommerce version you use. The file should be in ZIP format.

In the WordPress admin go to “Plugins”, choose “Add new” and then “Upload plugin”. Select the downloaded file, run the installation and activate the module.

Make a backup of the shop before installing. Check the available updates for WordPress, WooCommerce and the theme you use as well. A payment plugin is best tested on a current, supported environment. An old version of PHP or WooCommerce can cause errors in the checkout and in notification handling.

After activation go to “WooCommerce”, then “Settings” and the “Payments” tab. A Przelewy24 item should appear on the list.

Step 2. Enter the details from the panel: merchant ID, CRC key and API key

Open the Przelewy24 settings and switch this payment method on. In the right fields enter the merchant ID, the shop ID or POS ID, the CRC key and the API key.

In a basic setup the merchant ID and the POS ID usually have the same value. If several points of sale have been created on the account, use the details assigned to the right shop. Look in the Przelewy24 panel instead of guessing the number from another integration.

Production and test details belong to two separate environments. If you are setting up the sandbox, all the values you enter have to come from the test account. Mixing a production ID with a test CRC key will end in a connection error.

After saving the settings, use the access test if the plugin offers one. A correct result confirms the connection to the account. You still need a trial order, because the details test alone does not check how the basket works, the return from payment or the status change.

Step 3. Set the payment methods in the checkout

Switch on the methods your customers are meant to use. A good set to begin with covers BLIK, fast transfers and cards. With more expensive products you can add instalments or deferred payments, if they are active in your agreement.

The number of visible options affects how the checkout looks. A dozen or more separate bank tiles can make the form needlessly long on a phone. It is often better to highlight two or three popular methods and show the rest after the customer goes to the Przelewy24 payment page.

Set a clear name for the payment, for example “Przelewy24: BLIK, fast transfer or card”. The customer knows straight away what options they will find after choosing it. Check the order of the methods too. Online payments should sit high up, especially when most orders are paid online.

Whether particular options are available can depend on the currency. Instalments are usually shown for orders in Polish zloty, and handling cards in other currencies needs the account to be configured properly. With a multi-currency shop, test each currency separately.

Step 4. Save and check the payment page with a test order

Save the settings, clear the shop’s cache and open the site in a private browser window. Add a product to the basket, go through the checkout and choose Przelewy24.

Check that the method shows on a computer and on a phone. Pay attention to the consent relating to the payment operator, the error messages, the move to payment and the page shown after the return to the shop.

When the transaction is finished, open the order in WooCommerce. The status should change from “Pending payment” to the status used for paid orders, most often “Processing”. The full list is described in the WooCommerce order documentation. Confirm that the transaction is present in the Przelewy24 panel as well, and that the amount, the currency and the order number match.

The sandbox and going to production

The sandbox lets you go through the whole process without taking money from a real account. After successful tests you replace the details with the production ones, switch off test mode and make the first real control payment.

You start the test account from your Przelewy24 account. The sandbox has its own ID, CRC key and API key. Copy the whole set of details into the plugin settings, then switch on test mode.

Run several scenarios. Check a successful payment, cancelling it on the payment page and returning to the shop without finishing the transaction. If you sell in several currencies, run a test for each of them. For refunds, test a partial and a full refund too.

When everything works, switch off the sandbox and remove the test details from the configuration. Paste in the full set of production keys, save the settings and check the connection again.

Place the first production order for a small amount. Pay with a real method, wait for the status to update and compare the record in WooCommerce with the transaction in the operator’s panel. Checking a few screens takes a couple of minutes and confirms that the whole path works.

Common integration errors and how to fix them

Most problems with the Przelewy24 WooCommerce integration are caused by mixed-up access details, the cache or blocked notifications from Przelewy24. Start by checking the environment, the keys, and the amount and currency of the transaction.

A CRC error usually means a typo, an extra space or a key from a different account. A frequent case is production details combined with the sandbox. Copy the whole set again, make sure the plugin’s mode matches the panel you chose, and run the access test.

It also happens that the customer pays correctly but the order is still waiting for payment. The cause is often blocked return notifications. Clear the cache and, as a test, switch off optimisation for the basket, the checkout and the addresses that handle payments. Check the firewall rules, the hosting’s security features and the WooCommerce error log.

The next lead is a mismatched amount or currency. The problem can appear with discount plugins, currency converters, rounding or a change in the order value after the payment has started. Compare the data saved in WooCommerce with the information shown on the transaction in Przelewy24.

A conflict can also be caused by a second payment plugin or a tool that modifies the checkout. Switch off the suspect extensions one at a time on a test copy of the shop. Place a new order after every change, because an old payment session may hold the earlier data.

Switch on the Przelewy24 and WooCommerce logs while you diagnose. Order numbers, API messages and notification times usually show the moment at which the process broke. Once the problem is solved, switch the detailed logging off to limit the amount of data stored.

Przelewy24 fees in practice

Przelewy24 charges for standard payments through a fee on each transaction and takes no monthly subscription. You can check current rates in the operator’s public price list, in your panel and in your agreement.

According to the standard price list, BLIK, fast transfers and payment cards are charged at 1.9% or 1.29% + PLN 0.30 per transaction, depending on the variant chosen. The terms may differ with an individual offer, additional methods or a promotional programme. Before launching the shop, base your calculation on the rate assigned to your account.

The fixed PLN 0.30 matters more with small baskets. For an order of PLN 20 the cost in the 1.29% + PLN 0.30 variant is about PLN 0.56, or roughly 2.8% of the sale value. With a basket of PLN 50 it is about PLN 0.95, and with PLN 200 about PLN 2.88. If you sell cheap products, allow for this difference in your margin or set a sensible minimum order value.

Registration, integration and the monthly subscription are PLN 0 as standard. The activation fee is PLN 59 and is refunded after 10 production transactions made within the first two months of working together.

Issuing a refund is itself free. The fee taken for handling the original payment stays charged, because the transaction was carried out. With a large number of refunds this cost should go into the margin calculation too. Fees are only part of a shop’s budget anyway. You will find the full breakdown in the article how much does an online store cost.

Where to start

Start with the merchant account and getting the shop ready for verification. Then set up the sandbox, run trial transactions, enter the production details and check one real order.

Setting up Przelewy24 for WooCommerce yourself makes sense when the shop uses standard WooCommerce, one language, one currency and a simple checkout. Installing the official plugin and filling in the details then usually takes less work than looking for something written specially for the shop.

Technical help is useful with several currencies, recurring payments, a modified checkout and conflicts between plugins. The same goes for a shop that is already selling, where every break in payments means lost orders. In that case the setup has to be combined with a backup, tests on a separate environment and a controlled rollout. That is how it went, for example, with the Pokrycianadach.pl shop, which I built on WooCommerce. And if you would prefer to hand the whole thing to one person: I take WooCommerce shops from the mockup to the first order.

If you are comparing payment gateways, see my guide to the PayU integration with WooCommerce as well.

FAQ

How much is the Przelewy24 fee in WooCommerce?

According to the standard price list, BLIK payments, fast transfers and cards are charged at 1.9% or 1.29% + PLN 0.30 per transaction, with no monthly subscription. The PLN 59 activation fee is refunded after 10 transactions within the first two months. You will find individual rates in your agreement and in the panel.

Does the Przelewy24 WooCommerce integration need a developer?

With a standard shop, usually not. The official plugin and three details from the panel (the merchant ID, the CRC key, the API key) are enough to get payments running in one afternoon. Technical help is useful with several currencies, a modified checkout or plugin conflicts.

How do I test Przelewy24 payments before the shop launches?

Switch on the sandbox test account, enter its details in the plugin and go through the full path: a successful payment, a cancelled transaction and a return to the shop without paying. After testing, replace the details with the production ones and place one real order for a small amount.

Why does the order in WooCommerce not change status after payment?

Most often the return notification from Przelewy24 does not reach the shop. Check the cache and its exclusions for the checkout, the firewall rules, the hosting’s security features and the WooCommerce logs. Comparing the amount and the currency of the order with the transaction in the operator’s panel can help too.

Does Przelewy24 support BLIK in WooCommerce?

Yes. BLIK is one of the basic methods available in the integration, alongside fast transfers and cards. Selected BLIK variants can work directly in the shop, without going to the operator’s site. That depends on the plugin settings and your account.

Filip Chrapek

Let's work together

What do you need?
Budget
When?

Prefer email? hi@philgood.dev