↑↓ selectEnter openEsc close

    1. Elbuz

    How to accept PayU payments in your store

    6 min readUpdated

    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

    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.

    1. Get the four keys in the PayU panel (where exactly).
    2. Open the module screen. “Store settings” → the “Checkout & payment” section → the PayU card.
    3. In the “Connection” block, turn off “Test mode (sandbox)” and enter the keys.
    4. In the “Payment” block, choose the “Currency of the POS” — the one your PayU point works in (why this matters).
    5. Turn on the “Enabled” switch at the top of the screen.
    6. Click “Save”. The settings go to the store right away: “Saved and applied in the store” appears at the bottom.
    The Checkout & payment section of store settings with the PayU module card
    1PayU card
    2Enabled switch
    1. PayU card: click it to open the setup screen.
    2. Whether shoppers see this payment method; the card also shows whether the latest changes reached the store.
    PayU setup screen, maximized, with the Connection block and the checklist
    1Enabled switch
    2Test mode (sandbox)
    3POS ID
    4Second key (MD5)
    5Still to set up
    1. Shows PayU to customers after saving.
    2. Test payments without charging money; turn it off before selling.
    3. The payment point number from your PayU account.
    4. The secret key: after saving it is not shown, only marked as set.
    5. 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 ElbuzWhat 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.

    The Payment block with the POS currency and the BLIK code switch next to the checklist
    1Currency of the POS
    2BLIK code at checkout
    3No PLN in the store
    1. The currency of the PayU payment point: the method is shown only to customers with prices in this currency.
    2. Lets the customer enter the BLIK code right at checkout, PLN only.
    3. 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.

    1. Ask your PayU manager to enable “Transparent payment with a BLIK authorization code” for your point. Without it, PayU rejects the code.
    2. In the “Payment” block, turn on “BLIK code at checkout”. The switch is visible only with PLN as the currency.
    3. 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.

    1. 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.
    2. “Currency of the POS” — PLN. Check that the store has PLN (above).
    3. Turn the module on and save.
    4. 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.”
    5. Pay with a test card or BLIK code from the PayU documentation. The code 777123 gives a successful payment.
    6. 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 happenedWhere the customer returns
    PaidThe order success page
    A BLIK payment or transfer is still on its wayAlso 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 storeCheckout 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.

    The PayU «Order statuses» block with four status fields
    1Paid
    2Waiting for confirmation
    3Refunded
    4Canceled
    1. Paid — the status an order gets when PayU has confirmed the payment.
    2. Waiting for confirmation — the money is blocked on the buyer's card and is charged after confirmation through Elbuz support.
    3. Refunded — the status after a full refund.
    4. Canceled — the status when a payment that was waiting for confirmation is canceled: at your request, or by PayU itself after a few days.
    FieldWhen it is setDefault
    PaidPayU confirmed the payment. The customer gets the usual order email“Processing”
    Waiting for confirmationAutomatic receipt of payments is off in the PayU point: the money is blocked and charged after confirmation. No email goes to the customer“Pending”
    RefundedThe full amount was refunded to the customer“Refunded”
    CancelledA 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:

    ButtonWhen it's thereWhat it does
    RefundThe payment is completed and there's still something to refundReturns 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 holdThe payment is waiting for confirmationCharges the money; the status from the “Paid” field. Only the full amount: PayU doesn't capture part
    Release holdThe payment is waiting for confirmationCancels the payment, the money goes back to the customer. The status from the “Cancelled” field
    Refresh statusAlwaysGets 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 seeWhyWhat 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

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free