Przelewy24 sends the customer to its secure page: BLIK, a Polish bank transfer or a card. The store gets the result, confirms the payment at Przelewy24 and sets the order status.
When you need this:
- You sell in Poland in zloty — customers pay with BLIK.
- A purchase exceeds the card limit — a bank transfer goes through, and the order is paid automatically.
- The cart changed after going to payment — the order gets its own status, not paid.
- You refund part of the money — to the same account or card.
Where to start: “Store settings” → “Checkout & payment” → Przelewy24 → three keys and “Enabled”.
What Przelewy24 payments can do
- Take payments on the Przelewy24 page — BLIK, Polish bank transfers, card, Apple Pay, Google Pay.
- Check with a test payment — no money is charged.
- Set the order status on its own — after payment and after a full refund.
- Refund the full amount or part of it — with a button in the order card, in several parts.
How to connect Przelewy24
Your company needs a contract with Przelewy24. Elbuz has no shared keys: the module works only with keys from your own panel. Przelewy24 sets the terms and fees.
- Get the Merchant ID, the CRC key and the API key in the Przelewy24 panel (where exactly).
- Enter the store server IP address in the panel (how). Without it the API key doesn't work and the payment page won't open.
- Open the module screen. “Store settings” → the “Checkout & payment” section → the Przelewy24 card.
- In the “Connection” block, turn off “Test mode (sandbox)” and fill in “Merchant ID”, “CRC key” and “API key”. Test mode is on by default.
- Turn on the “Enabled” switch at the top of the screen.
- Click “Save”. The settings go to the store right away, and “Saved and applied in the store” appears at the bottom.
1
Przelewy242
Status badge- The Przelewy24 payment module card: click it to open the module screen.
- Whether shoppers can see this payment method and whether the latest changes have reached the store.
1
Enabled switch2
Test mode (sandbox)3
Merchant ID4
CRC key5
API key6
What is not configured yet7
Mode- Shows Przelewy24 to customers after saving.
- Test payments without charging money; on by default.
- Account number from the Przelewy24 panel.
- Klucz do CRC: verifies the signature of payment messages; hidden after saving.
- Klucz do raportów from the same panel section.
- What is missing for payment to work: keys, PLN currency, test mode.
- Whether the module is in test or live mode right now.
An enabled module won't save without the three keys: the field shows “Required — the module will not work without it”. The CRC key and the API key aren't shown after saving — the screen only tells you they are set. To change one, click “Replace” and enter the new key.
On the right, “Still to set up” shows what's missing: keys, the PLN currency, test mode still on. In “Status in the store”, the “Mode” line shows “Test mode” or “Live mode”. How the window works in general is covered in “Store settings”.
Where to find the keys in the Przelewy24 panel
The Przelewy24 panel (panel.przelewy24.pl) is in Polish. Copy the keys with the copy button in the panel.
| Field in Elbuz | Where in the panel | What matters |
|---|---|---|
| Merchant ID | The registration email and the top of the panel | Digits only, up to 10 characters |
| Shop ID (POS ID) | Same place, if the company has several shops | Usually the same as the Merchant ID — then leave it empty |
| CRC key | Moje dane → Dane API i konfiguracja → “Klucz do CRC” | Checks the signature of every payment notification |
| API key | Same place → “Klucz do raportów” | The store signs in to the Przelewy24 API with it |
Store server IP address
Without the IP address in the panel, the Przelewy24 API key doesn't work. The “Connection” block on the module screen shows the address: the “Store server IP address” line with a “Copy” button.
- Save the API key in the panel: Moje dane → Dane API i konfiguracja.
- Below, in the “Adres IP” field under the API key, paste the store server IP address.
- Click “Zachowaj”.
1
Store server IP address2
Copy button3
Notification address- Enter this address in the IP address field of your Przelewy24 panel.
- Copies the address.
- The module sends this address itself; you do not need to enter it in the panel.
If the store moves to another server, the address changes — enter the new one.
The “Notification address” in the “Connection” block is for reference. The module sends it with every payment, so there's nothing to enter in the panel. If the site is protected by Cloudflare or a password, this address must stay open.
Prices in zloty
The module works only with PLN and doesn't convert amounts. The method appears at checkout only when the customer sees prices in zloty. If they switch the site to EUR, they won't see Przelewy24.
While PLN isn't among the store currencies, the right side shows “The store has no PLN currency — customers will not see this payment method”. Currencies get to the store from the “Currencies” window with the next export. PLN must have “Activity” and “Show on site” on.
The store's main currency is the same as the main currency in Elbuz.
How to check with a test payment
Test mode sends payments to the Przelewy24 sandbox, and no money is charged. You turn on the test account from the live one: Moje konto → Konto SANDBOX. It has its own keys; live keys don't work in the sandbox.
- Copy the three keys from the test account.
- On the module screen, leave “Test mode (sandbox)” on, enter the test keys, enable the module and save.
- Switch the site to PLN, place an order for yourself and choose Przelewy24. Above the redirect you'll see “Test mode (Przelewy24 sandbox): no money is charged.”
- Pay on the test page, for example with the BLIK code
777and any three digits. The order gets the status from the “Paid” field. The customer email shows “Przelewy24: paid …” marked “[TEST]”. - Turn off “Test mode (sandbox)”, enter the live keys and save.
While test mode is on, the right side shows “Test mode is on — no money is charged. Turn it off before you start selling”.
What the customer sees and for which orders
At checkout the method is called “Przelewy24: BLIK, bank transfer, card”. After confirming, the customer sees “Taking you to the Przelewy24 payment page…” and lands on the Przelewy24 page. Which methods are shown there depends on your Przelewy24 contract.
| What happened | Where the customer returns |
|---|---|
| Paid | The order success page |
| Didn't pay or closed the page | Checkout with “The payment was not completed. Please try again or choose another payment method. If the money has already been taken, the order will be confirmed by itself in a few minutes.” The cart and details are kept |
| The payment page didn't open | Stays at checkout: “Could not open the payment page…” and a “Pay” button to try again |
The page language is the store's main language, not the one the customer chose. Przelewy24 supports Polish, English, German, French, Spanish, Italian and a few more. For Ukrainian and Russian it uses English.
For which orders to show it
The “Where to show” block:
- “Geo zone” — the payment is shown only to customers with an address in this zone; “All zones” — to everyone.
- “Sort order” — the position in the payment list; a smaller number goes higher. The default is
1, as for other payment methods.
The method name and description, the minimum or maximum order total, and the link to shipping methods are set up by Elbuz support. These are checkout settings.
Order statuses
The store sets the status itself when Przelewy24 reports a payment. You choose which ones in the “Order statuses” block.
1
Paid2
Refunded3
Status if the payment total does not match- Set when Przelewy24 reports the payment and the store confirms it.
- Set after a full refund.
- The customer paid the old amount: the order arrives with this status instead of paid.
| Field | When it is set | Default |
|---|---|---|
| Paid | Przelewy24 reported the payment and the store confirmed it. The customer gets the usual order email | “Processing” |
| Refunded | The full amount was refunded to the customer with the “Refund” button in the order card | “Refunded” |
| Status if the payment total does not match | The customer paid the old amount, but the cart changed in the meantime. The money is in, so the order is confirmed with this status | “Pending” |
The store confirms every payment at Przelewy24 — without that, Przelewy24 doesn't transfer the money. Until the customer pays, the order stays unconfirmed. A repeated payment attempt doesn't create an extra order.
The amount-mismatch status must differ from “Paid”. Otherwise the module uses the store's new-order status, and if that one is the same as “Paid” too, the order stays unconfirmed.
When the order doesn't become paid
- Wrong amount. The customer changed the cart after going to payment and paid the old amount, higher or lower. The order arrives in Elbuz with the amount-mismatch status from the “Order statuses” block. Check the amount in the Przelewy24 panel: refund the difference or agree with the customer.
- Second payment. The customer paid for an order that was already paid. The status doesn't change, and both payments are visible in the Przelewy24 panel — refund the extra one.
- Forged notification. The module checks the signature with the CRC key, the merchant number, the amount and the currency. Someone else's notification won't change the order.
Refunds and payment status in the order card
An unpaid order doesn't arrive in Elbuz. A paid one appears among “Customer order” documents with the payment type “Online payment”. Its card has a “Payment in Przelewy24” block: payment status, amount, charged, refunded and how much is still refundable.
Below are all payment attempts. Only the buttons available for the order right now are shown:
| Button | What it does |
|---|---|
| Refund | Returns the full amount or part of it, several times. The amount field is prefilled with the balance: to refund everything, keep the suggested amount |
| Refresh status | Gets the payment status from Przelewy24 if a notification didn't arrive. If the customer actually paid, the order becomes paid |
Before a refund, the program asks you to confirm, with the warning “This operation cannot be undone.”. The order status changes the same way as after a Przelewy24 notification.
Przelewy24 takes a few minutes to process a refund: “Refunded” in the block updates once it's done. An amount in progress no longer counts toward “Refundable”. The customer gets no refund email.
| Refund | Order status |
|---|---|
| Part of the amount | Stays the same |
| Full amount | From the “Refunded” field |
| Przelewy24 rejected the refund | Stays the same |
If the store didn't respond, you'll see “It is unknown whether the operation went through. Click “Retry”: the money will not move a second time”. “Retry” repeats the same operation, while clicking “Refund” again starts a new refund.
Only a user with the “Payment operations: refund, hold, credit” permission can make refunds — by default, the owner. “Refresh status” is available to everyone who can see the order.
You can also refund in the Przelewy24 panel. But then the order status stays the same.
The module screen header shows Przelewy24 orders for the last 30 days: count, total, average order value and the share of canceled or refunded ones.
Scenarios
Home appliances: a fridge that costs more than the card limit
A customer wants a fridge for PLN 6,000, but their card limit is lower. Check in the Przelewy24 panel that BLIK and bank transfers are on — they're standard in a Polish contract. The card limit no longer gets in the customer's way.
Clothing: refunding two jackets out of three
A customer ordered a jacket in three sizes and is returning two. In the order card, click “Refund” and enter the price of two jackets, for example 598.00. Przelewy24 returns that part to the same account, and the status stays paid.
Coffee: paying from a phone in a minute
Most coffee customers order from their phones. Set “Sort order” to 0, lower than for other payment methods, so Przelewy24 comes first. Elbuz support can set a short method name, such as “BLIK or transfer”.
What to do when payments don't work
| What you see | Why | What to do |
|---|---|---|
| The customer doesn't see Przelewy24 at checkout | The module is off, the keys aren't set, prices aren't in PLN, the address is outside the “Geo zone”, or the method is restricted in the checkout settings | Check “Enabled”, the three keys, the PLN currency and “Geo zone”, then “Save”. Still not working — Elbuz support will check the checkout settings |
| “Could not open the payment page” | The store server IP address isn't entered in the panel, a key is wrong, or test keys are used with test mode off (or the other way round) | Copy the “Store server IP address” from the module screen into the panel's “Adres IP” field (how), paste the keys again and check “Test mode (sandbox)”. Still not working — Elbuz support will look at the Przelewy24 response |
| The payment went through, but the status didn't change | Przelewy24 notifications don't reach the store: the site has no HTTPS, or the notification address is blocked by protection or a password | Click “Refresh status” in the order card. Then open the “Notification address” to Przelewy24 |
| You refunded the full amount, but the status didn't become “Refunded” | Przelewy24 is still processing the refund | Wait a few minutes. No change after an hour — click “Refresh status” in the order card |
| “The store did not accept the settings” or “The store did not accept some values: see the highlighted fields” | The store didn't respond or rejected some fields | Fix the highlighted fields and save. If no fields are highlighted, the changes will go with the next export |
FAQ
Can a store that also sells in Ukraine accept Przelewy24?
Yes. Customers paying in hryvnias simply won't see Przelewy24 — the method appears only for prices in zloty. For hryvnias, connect LiqPay or another Ukrainian service.
What happens if I disable the module?
Przelewy24 disappears from checkout. The keys and settings are kept: turn it back on and everything is in place.
Can I send the customer a Przelewy24 payment link from Elbuz?
Yes, but that's a separate connection with its own keys in Elbuz: Payment links.
How do I check that the keys and the IP address are correct?
Contact Elbuz support — they will check the connection to Przelewy24. Or make a test payment.
How do I refund a Przelewy24 payment to the customer?
In the order card in Elbuz, click “Refund” in the “Payment in Przelewy24” block. The customer gets no refund email.
The “Geo zone” list doesn't have the zone I need — what do I do?
Elbuz support creates the zone, for example “Poland”. Then choose it in the “Where to show” block.
Where to find it and who has access
- Menu
- Directories → Operations → Store settings → “Checkout & payment” → Przelewy24
- Access rights
- the “Store settings” window in group permissions
- Prepare
- a contract with Przelewy24, three keys, the store server IP in the panel, the PLN currency
Related topics
- If you need to understand how the store settings window works — Store settings.
- If zloty isn't among the site currencies — Currencies.
- If you need another Polish payment service — How to accept PayU payments in your store.
- If you need to process a paid order in Elbuz — Customer order.
