PayU handles payment on its own secure site: BLIK, bank transfers, cards, Apple Pay and Google Pay. The store learns the outcome and updates the order status.
When you need this:
- You sell to Poland — customers pay with BLIK and bank transfers, as usual.
- The customer won't leave the site — the BLIK code is entered at checkout.
- Goods need checking first — the money is charged only after your confirmation.
- A partial refund — PayU refunds part, the status stays paid.
Where to start: “Store settings” → “Checkout & payment” → PayU → four keys and the “Enabled” switch.
What PayU payments can do
- Take payments on the PayU page — BLIK, bank transfer, card, Apple Pay, Google Pay.
- Take the BLIK code at checkout — without going to the PayU page.
- Work in test mode — no money is charged, and you can leave the keys empty.
- Set the order status on its own — paid, waiting for confirmation, refunded, canceled.
- Charge the money after your confirmation and refund the full amount or part of it — with buttons in the order card.
How to connect PayU
You need a contract between your company and PayU and a REST API payment point in the PayU panel. Elbuz has no shared keys: the module works only with yours.
- Get the four keys in the PayU panel (where exactly).
- Open the module screen. “Store settings” → the “Checkout & payment” section → the PayU card.
- In the “Connection” block, turn off “Test mode (sandbox)” and enter the keys.
- In the “Payment” block, choose the “Currency of the POS” — the one your PayU point works in (why this matters).
- Turn on the “Enabled” switch at the top of the screen.
- Click “Save”. The settings go to the store right away: “Saved and applied in the store” appears at the bottom.
1
PayU card2
Enabled switch- PayU card: click it to open the setup screen.
- Whether shoppers see this payment method; the card also shows whether the latest changes reached the store.
1
Enabled switch2
Test mode (sandbox)3
POS ID4
Second key (MD5)5
Still to set up- Shows PayU to customers after saving.
- Test payments without charging money; turn it off before selling.
- The payment point number from your PayU account.
- The secret key: after saving it is not shown, only marked as set.
- What is still missing for the payment to work.
With test mode off, an enabled module won't save without all four keys: an empty field shows “Required — the module will not work without it”. “Second key (MD5)” and “OAuth client secret (client_secret)” aren't shown after saving — only “set”. To change one, click “Replace”.
You don't need to enter the payment notification address in the PayU panel: the module sends it with every payment. The screen shows it for reference as “Notification address”. If the site is behind Cloudflare or a password, this address must stay open.
How the window works in general is covered in “Store settings”.
Where to get the keys in the PayU panel
The PayU panel (panel.payu.pl) is in Polish. The path: “Płatności elektroniczne” (online payments) → “Moje sklepy” (my shops) → your shop → “Punkty płatności” (payment points) → the “REST API (Checkout)” point → “Klucze konfiguracji” (configuration keys). No such point — create one: “Dodaj punkt płatności” (add a payment point).
| Field in Elbuz | What to copy in the PayU panel |
|---|---|
| Point of sale ID (POS ID) | Id punktu płatności (pos_id) |
| Second key (MD5) | Drugi klucz (MD5) — the store uses it to check the signature of every PayU notification |
| OAuth client ID (client_id) | Protokół OAuth — client_id, usually the same number as the POS ID |
| OAuth client secret (client_secret) | Protokół OAuth — client_secret |
Copy with the button in the panel, without spaces at the start or end.
Payment point currency: who sees PayU
A PayU payment point works in one currency, most often PLN. The module doesn't convert amounts. So PayU appears at checkout only when the customer sees prices in the point's currency.
- “Currency of the POS” — PLN, EUR, USD, GBP, CZK, HUF, RON, BGN, CHF, DKK, NOK or SEK. PLN by default.
- The customer must see prices in this currency. In the Elbuz “Currencies and rates” window, the PLN row needs “Activity”. If PLN isn't the Elbuz main currency, it also needs “Show on site” and a rate: Currencies and rates.
- If the store lacks the currency, the right side shows “The store has no PLN currency — customers will not see this payment method”.
The point is in PLN, but the customer switched the site to EUR — they won't see PayU. Two currencies need two PayU points, and the module works with one.
1
Currency of the POS2
BLIK code at checkout3
No PLN in the store- The currency of the PayU payment point: the method is shown only to customers with prices in this currency.
- Lets the customer enter the BLIK code right at checkout, PLN only.
- The store has no PLN currency, so customers will not see PayU.
For which addresses and in which position
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 module has no order total limit: PayU is shown for any amount.
The BLIK code right in the store
The customer enters the 6-digit BLIK code at checkout and confirms the payment in their banking app. They don't go to the PayU page.
- Ask your PayU manager to enable “Transparent payment with a BLIK authorization code” for your point. Without it, PayU rejects the code.
- In the “Payment” block, turn on “BLIK code at checkout”. The switch is visible only with PLN as the currency.
- Click “Save”.
The customer sees the “BLIK code” field, the “Pay with BLIK” button and the “Another payment method (PayU page)” link. After entering the code — “Confirm the payment in your banking app. Waiting for the answer…”.
The store waits about two minutes for the bank's confirmation. If it doesn't come, the customer sees “The bank has not confirmed the payment yet…” and can enter a new code. If they've already confirmed the payment in the bank, the order becomes paid on its own.
Wrong, expired or already used code — the customer sees what happened and gets a new code in the app. The store passes the code only to PayU and doesn't store it anywhere.
How to check in test mode
Test payments go to the PayU test environment (sandbox), and no money is charged. “Test mode (sandbox)” is on by default.
- Leave “Test mode (sandbox)” on and all four keys empty — the module uses the public PayU test point in PLN. Or enter the keys of your PayU test account.
- “Currency of the POS” — PLN. Check that the store has PLN (above).
- Turn the module on and save.
- Open the site in PLN, place an order for yourself and choose “Pay with PayU”. Above the redirect you'll see “Test mode (PayU sandbox): no money is charged.”
- Pay with a test card or BLIK code from the PayU documentation. The code
777123gives a successful payment. - Check that the order arrived in Elbuz with the status from the “Paid” field.
In test mode, enter either all four keys or none. If only some are entered, the empty fields show “All four keys are needed — or leave all of them empty (PayU test point)”.
Before you start selling, switch “Test mode (sandbox)” off and enter live keys: anyone knows the public test keys. While the 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
At checkout the method is called “Pay with PayU”, with the hint “BLIK, online transfer from your bank, card, Apple Pay, Google Pay…”. After confirming, the customer sees “Taking you to the PayU payment page…” and lands on the PayU page.
| What happened | Where the customer returns |
|---|---|
| Paid | The order success page |
| A BLIK payment or transfer is still on its way | Also the order success page. The order becomes paid as soon as PayU notifies the store — usually within a minute or two |
| Didn't pay and came back to the store | Checkout with “The payment was not completed. Please try again or choose another payment method.” The cart is kept |
Which methods appear on the PayU page depends on your contract with PayU. The page opens in the store's main language, not the language the customer chose.
Each payment attempt is a separate payment in PayU, while the store order stays the same. A new attempt cancels the previous unpaid one in PayU. If the old attempt is still paid with a different amount, the status won't change (below).
Order statuses
The store sets the status itself when PayU reports a payment. You choose which ones in the “Order statuses” block.
1
Paid2
Waiting for confirmation3
Refunded4
Canceled- Paid — the status an order gets when PayU has confirmed the payment.
- Waiting for confirmation — the money is blocked on the buyer's card and is charged after confirmation through Elbuz support.
- Refunded — the status after a full refund.
- Canceled — the status when a payment that was waiting for confirmation is canceled: at your request, or by PayU itself after a few days.
| Field | When it is set | Default |
|---|---|---|
| Paid | PayU confirmed the payment. The customer gets the usual order email | “Processing” |
| Waiting for confirmation | Automatic receipt of payments is off in the PayU point: the money is blocked and charged after confirmation. No email goes to the customer | “Pending” |
| Refunded | The full amount was refunded to the customer | “Refunded” |
| Cancelled | A payment waiting for confirmation was canceled: the money goes back to the customer | “Canceled” |
Until the customer pays, the order stays unconfirmed and doesn't count as new. A repeated payment attempt doesn't create an extra order.
When the status doesn't change
- Wrong amount. The customer changed the cart after going to payment and paid the old amount. The payment is in the PayU panel, but the order in Elbuz keeps its previous status. Check the amount and refund the payment if needed (how).
- Forged notification. The store checks the signature with the second key, then asks PayU itself for the point, attempt number, amount and currency. Someone else's notification won't change the order.
- PayU didn't answer the check. The store changes nothing, and PayU repeats the notification later.
Confirmation, cancellation and refunds in the order card
A site order arrives in Elbuz as a “Customer order” document with the payment type “Bank card”. Its card has a “Payment in PayU” block: payment status, amount, captured, refunded and how much is still refundable. Below are all payment attempts.
Only the buttons available to the order right now are shown:
| Button | When it's there | What it does |
|---|---|---|
| Refund | The payment is completed and there's still something to 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 |
| Capture hold | The payment is waiting for confirmation | Charges the money; the status from the “Paid” field. Only the full amount: PayU doesn't capture part |
| Release hold | The payment is waiting for confirmation | Cancels the payment, the money goes back to the customer. The status from the “Cancelled” field |
| Refresh status | Always | Gets the payment status from PayU if a notification didn't arrive |
Before any money operation the program asks for confirmation; for a refund or hold release — with the warning “This operation cannot be undone.”. The order status changes the same way as after a PayU notification.
PayU takes a few minutes to process a refund: “Refunded” in the block changes once it's done. After a full refund — the status from the “Refunded” field; after a partial one the status stays the same. The customer gets no refund email.
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 the button again starts a new one.
Only a user with the “Payment operations: refund, hold, credit” permission can refund money and manage holds — by default, the owner. “Refresh status” is available to everyone who can see the order.
If you don't capture the hold, PayU cancels the payment within a few days (the term depends on the payment method), and the money goes back to the customer. Keep an eye on orders with the status from the “Waiting for confirmation” field.
You can also refund in the PayU panel — the “Refund” action in the transaction list.
Once there are orders through PayU, the module screen header shows 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
Ask PayU to enable BLIK and fast transfers for your point. A customer buying a fridge for PLN 6,000 pays by transfer from their bank, so the card limit doesn't get in the way. The order becomes paid on its own.
Electronics: charge only after checking stock
In the PayU panel, turn off automatic receipt of payments for the point (“autoodbiór” in Polish). In “Waiting for confirmation”, choose the status the warehouse uses to check stock.
In stock — click “Capture hold” in the order card; out of stock — “Release hold”, and the customer gets the money back. Don't delay: PayU cancels an unconfirmed payment itself within a few days.
Clothing: three sizes ordered, one kept
The customer returns two jackets out of three. In the order card, click “Refund” and enter the price of two jackets, for example 598.00. PayU refunds part, the status stays paid, and the refunded amount is visible in the “Payment in PayU” block.
Coffee: selling to the eurozone
Ask PayU to open a point in EUR and enter its keys. “Currency of the POS” — EUR; in the “Currencies and rates” window, turn on EUR for the site. Customers with prices in euros pay without conversion, and the amount in PayU exactly matches the order total.
Cosmetics from a phone: paying without going to another site
The point is in PLN, and PayU has enabled BLIK by code. Turn on “BLIK code at checkout”. The customer enters the code from their banking app, confirms the payment — and sees the order success page right away.
What to do when payments don't work
| What you see | Why | What to do |
|---|---|---|
| The customer doesn't see PayU at checkout | The module is off, there are no keys (and test mode is off), the customer sees prices in another currency, or the address isn't in the geo zone | Check “Enabled”, the keys, “Currency of the POS” and “Geo zone”, then “Save” |
| The customer sees “Could not open the payment page” | A mistake in the keys, or the PayU point works in another currency | Paste the keys from the panel again and check the point's currency. Still not working — Elbuz support will turn on the request log and check the PayU response |
| The BLIK code is rejected every time | PayU hasn't enabled BLIK code payments for the point | Have your PayU manager turn on “Transparent payment with a BLIK authorization code” |
| The payment went through, but the status didn't change | PayU notifications don't arrive: 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” from the “Connection” block |
| A full refund was accepted, but the order status didn't change | PayU is still processing the refund | Wait a few minutes: the status changes as soon as PayU completes the refund |
| “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 from Ukraine connect PayU?
The module works with any PayU payment point. Whether PayU signs a contract with your company and which methods it opens is PayU's decision.
What happens if I turn the module off?
PayU disappears from checkout. The keys and settings are kept: turn it back on and everything is in place.
Can I send the customer a PayU payment link from Elbuz?
No. Payment links from the order card work with other services: Payment links.
How do I confirm a payment that is waiting for confirmation?
In the order card in Elbuz, click “Capture hold” in the “Payment in PayU” block. Only the full amount is charged: PayU doesn't capture part.
The zone I need isn't in the “Geo zone” list — what do I do?
Elbuz support creates the zone, for example “Poland”. Then choose it in the “Where to show” block.
How do I change the “Pay with PayU” name at checkout?
The module screen has no name field. Elbuz support changes it.
Where to find it and who has access
- Menu
- Directories → Operations → Store settings → “Checkout & payment” → PayU
- Access rights
- the “Store settings” window in group permissions
- Prepare
- a contract with PayU, a REST API point, four keys, the point's currency in “Currencies and rates”
Related topics
- If you need to understand how the store settings window works — Store settings.
- If the point's currency isn't in the store — Currencies and rates.
- If you also sell to the Baltic states — How to accept Paysera payments in your store.
- If you need to process a paid order in Elbuz — Customer order.
