Paysera sends the customer to a secure Paysera page: card, own bank, Apple Pay, Google Pay or Paysera wallet. The store then sets the order status itself.
When you need this:
- You sell to Lithuania, Latvia, Estonia or elsewhere in the EU — customers pay via their local bank.
- A bank transfer — in Checkout Classic the order waits in “Awaiting payment”, then becomes paid itself.
- The cart changed after the redirect — another amount won't become “Paid”.
- A partial refund — in Checkout Modern, a button in the Elbuz order card.
Where to start: “Store settings” → “Checkout & payment” → Paysera → API version, keys and “Enabled”.
What Paysera payments can do
- Take payments on the Paysera page — card, the customer's bank, Apple Pay, Google Pay, Paysera wallet.
- Work via Checkout Classic or Modern — a version switch and keys for that version.
- Check with a test payment — no money is charged.
- Set the order status on its own — paid, money on its way, refunded.
- Refund the full amount or part of it — in Checkout Modern, with a button in the Elbuz order card.
How to connect Paysera
You need a contract between your company and Paysera, the online payment collection service ordered, and a project for your site in your Paysera account. Until Paysera approves the project, only test payments go through.
- Choose the version. Checkout Classic works in all Paysera countries. Modern works only where Paysera has already opened it (see below).
- Open the module screen. “Store settings” → the “Checkout & payment” section → the Paysera card.
- In the “Connection” block, choose the “Paysera API version”. Only the key fields of that version remain below.
- Enter the keys from your Paysera account. For Classic — “Project ID” and “Project password”, for Modern — “Client ID” and “Client secret”.
- 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
Paysera row2
Status mark3
Set up button- The Paysera payment module row.
- Shows whether shoppers can see this payment method and whether the latest changes have reached the store.
- Opens the Paysera setup screen.
1
Enabled switch2
Paysera API version3
Test mode4
Project ID5
Project password6
Still to set up- Shows Paysera to customers once saved.
- Checkout Classic or Modern: only the keys of the chosen version remain below.
- Test payments without charging money (Classic only).
- The project number from the Paysera account.
- The secret project password: after saving it is not shown, only a mark that it is set.
- What is still missing for the payment to work.
The project password and Client Secret aren't shown after saving — the field only tells you they are set. To change one, click “Replace” and enter the new value. An enabled module won't save without the keys of the chosen version.
You don't need to enter the payment notification address in your Paysera account: the module sends it with every payment. The screen shows the address of the chosen version for reference: “Classic notification address” or “Modern notification address”.
If Paysera asks you to prove the site is yours (the verify-paysera meta tag), add the tag yourself: how to add a service code to the site. How the window works in general is covered in “Store settings”.
Checkout Classic or Modern
Paysera has two connection versions. The “Paysera API version” switch chooses which one payments go through. The default is Classic.
| Version | Keys | Where it works | Refunds |
|---|---|---|---|
| Checkout Classic | Project ID and project password | All Paysera countries | Only in your Paysera account |
| Checkout Modern | The project's Client ID and Client Secret | Currently Lithuania, Latvia, Estonia, Bulgaria, Kosovo, North Macedonia | Full amount or part — in the Elbuz order card |
Where to get the Classic keys
- “Project ID” — Paysera account → “Projects and activities”: the number next to the project name. Digits only, up to 11.
- “Project password” — your project → “General project settings”. Every payment is signed with it. At least 6 characters, no spaces.
Where to get the Modern keys
Paysera account → Checkout → your project → Integrations → API credentials: the Client ID and Client Secret are there. If your country doesn't have this section, stay on Classic.
The “Regenerate credentials” button in Paysera cancels the old Client Secret at once. After using it, enter the new one in the store, or payments will stop.
1
Paysera API version2
Client ID3
Client secret4
Modern notification address- Checkout Modern is selected, so only the client ID and secret fields remain.
- Client ID from Integrations → API credentials in your Paysera account.
- Client Secret from the same place; after “Regenerate credentials” in Paysera, enter the new one here.
- The module sends this address itself; you do not need to enter it in Paysera.
You can switch versions at any time. Payments already received aren't affected; new ones go through the chosen version.
How to check with a test payment
A test payment goes through the Paysera test page and no money is charged. It works even before the project is approved.
Checkout Classic
- In your Paysera account: project → “General project settings” → allow test payments.
- On the module screen, leave “Test mode” on, enter the keys, enable the module and save.
- Place an order for yourself and choose Paysera. Above the redirect you'll see “Paysera test mode: no money is charged.”
- Confirm the payment on the test page. The order arrives in Elbuz with the status from the “Paid” field.
- Turn off “Test mode” and save.
While test mode is on, the right side of the screen shows “Test mode is on — no money is charged. Turn it off before selling”. Once it's off, a test payment won't make an order paid — so a fake payment can't pass for a real one.
Checkout Modern
There's no “Test mode” switch for Modern on the screen. Test mode is turned on in the Paysera project itself: Merchant Portal → project → ⋮ → Enable Test Mode. Test cards are in the Paysera developer documentation.
What the customer sees and for which orders
At checkout the method is called “Paysera: card, bank, Apple Pay, Google Pay”. After confirming, the customer sees “Opening the Paysera payment page…” and lands on the Paysera page.
| What happened | Where the customer returns |
|---|---|
| Paid | The “Your order has been placed!” page |
| Canceled the payment | Checkout with “The payment was cancelled. You can pay again or choose another payment method.” The cart is kept |
| Didn't finish paying | Checkout with “The payment was not completed…”: they can try again or choose another method |
Which payment methods appear on the Paysera page depends on your Paysera contract and the customer's country. The amount is charged in the order currency. Check with Paysera whether your project accepts that currency.
The page language is the store's main language if Paysera supports it, not the language the customer chose. Classic supports Russian, German, Polish, Lithuanian, Latvian, Estonian and Bulgarian, Modern supports Lithuanian. For all others, Ukrainian included, it's English.
For which orders to show it
The “Where to show” block limits who sees Paysera:
- “Geo zone” — the method only for customers with an address in this zone; “All zones” — for everyone.
- “Minimum order total” — Paysera appears from this total in the store's main currency. Empty or
0— always. There's no maximum total. - “Sort order” — the position in the list of payment methods; a lower number is higher up.
Order statuses
The store sets the status itself when Paysera reports a payment. You choose which statuses in the “Order statuses” block.
1
Paid2
Awaiting payment3
Refunded- Set when Paysera confirms payment of the full amount.
- The money is still on its way (bank transfer), or the customer came back before the confirmation.
- Set after a full refund in Checkout Modern.
| Field | When it is set | Default |
|---|---|---|
| Paid | Paysera confirmed payment of the full order total. The customer gets the usual order email | “Processing” |
| Awaiting payment | The customer paid by bank transfer and the money is still on its way (Classic). Or the customer came back from Paysera before the confirmation | “Pending” |
| Refunded | The full amount was refunded to the customer (Modern only) | “Refunded” |
Until the customer pays, the order stays unconfirmed. Trying to pay again doesn't create an extra order.
An order with a transfer on its way has the status from the “Awaiting payment” field — don't ship it. Once Paysera confirms the money, the module sets “Paid” itself.
If the two fields match, the right side warns: “Paid” and “Awaiting payment” statuses are the same — a transfer in transit can't be told from a payment. Choose different ones.
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 visible in your Paysera account: agree on an extra payment with the customer or refund the money.
- Second payment. The customer paid for an order that is already paid. The extra payment is visible in your Paysera account — refund it.
- Test payment in live mode (Classic). “Test mode” is off, so the test payment is rejected.
- Fake notification. The module checks the Paysera signature, the amount and the currency, and in Classic also the project number. Someone else's notification won't change the order.
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 Paysera” block: payment status, amount, how much was charged and refunded. It also shows how much is still refundable and every payment attempt with its Paysera reference.
| Version | How to refund | What happens to the order |
|---|---|---|
| Checkout Modern | With the “Refund” button in the “Payment in Paysera” block. The full amount or part of it, several times, but no more than what's left | Partial — the status stays the same, the refunded amount is visible in the block. Full — the status from the “Refunded” field |
| Checkout Classic | Only in your Paysera account: the block in the card only shows the payment, with no buttons | Change the status yourself |
In Checkout Modern you see only the buttons available for the order right now:
| Button | What it does |
|---|---|
| Refund | Returns the full amount or part of it to the customer. The amount field is prefilled with the balance: to refund everything, keep the suggested amount |
| Refresh status | Gets the payment status from Paysera if the notification didn't arrive |
Paysera takes a few minutes to process a refund: an amount in progress no longer counts toward “Refundable”. The store doesn't email the customer about the refund.
Before a refund, the program asks for confirmation with the warning “This operation cannot be undone.”. The order status changes the same way as after a Paysera notification, and the order history gets an entry with the result.
If the store didn't respond, the program shows “It is unknown whether the operation went through…” and a “Retry” button. It repeats the same operation: the money won't move a second time. Clicking the button again starts a new operation.
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.
Once there are orders through Paysera, 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: customers from Lithuania pay through their bank
Sign a contract with Paysera and enter the “Project ID” and “Project password”. Set “Sort order” to 1 so Paysera comes first. The customer sees the banks of their country on the Paysera page, and the washing machine order becomes paid on its own.
An expensive TV paid by bank transfer
The store runs on Checkout Classic. In “Awaiting payment”, choose a status at which the warehouse doesn't ship. The TV won't go out until the module sets “Paid” — and that happens as soon as Paysera confirms the money.
Flowers: small orders paid in cash
The Paysera fee eats the margin on small orders. Set “Minimum order total” to 20: Paysera appears at checkout only from 20 in the store's main currency.
A coffee machine with cups: refund only the cups
The store runs on Checkout Modern. The customer returns the cups from the set — in the order card, click “Refund” and enter the price of the cups. Paysera refunds part of the money, the status stays paid, and you don't need to open your Paysera account.
What to do when payments don't work
| What you see | Why | What to do |
|---|---|---|
| The customer doesn't see Paysera at checkout | The module is off, the chosen version has no keys, the total is below the minimum, or the address isn't in the geo zone | Check “Enabled”, the keys, “Minimum order total” and “Geo zone”, then click “Save” |
| Classic: Paysera shows an error instead of the payment page | Wrong project ID or password, the project isn't approved yet, or test payments aren't allowed in the project | Paste the keys from your account again. For a test, allow test payments in the Paysera project |
| Modern: the customer sees “Could not open the payment page” | Wrong Client ID or Client Secret, or they were regenerated in Paysera | Enter the current keys from Integrations → API credentials and save |
| The payment went through, but the status didn't change | Paysera notifications don't reach the store: the site is behind a password or bot protection | Open the notification address from the “Connection” block to Paysera. In Modern, click “Refresh status” in this order's card in Elbuz. If that doesn't help, Elbuz support will check the module log |
| Classic: a test payment didn't make the order paid | “Test mode” is off in the module | Turn it on for the check and off afterwards |
| “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 Paysera?
The module works with any Paysera project. Whether Paysera signs a contract with your company and which payment methods it opens is up to Paysera.
What happens if I turn off the module?
Paysera disappears from checkout. The keys and settings are kept: turn it back on and everything is in place.
Can I send the customer a Paysera payment link from Elbuz?
No. The payment link from the order card works with other services: Payment links.
The zone I need isn't in the “Geo zone” list — what should I do?
Elbuz support creates the zone, for example “Lithuania”. Then choose it in the “Where to show” block.
Is this the same as Paysera delivery?
No. Paysera delivery (parcel lockers and couriers) is a separate module in the “Delivery” section, with its own settings.
How do I refund the customer?
In Checkout Modern, open the order in Elbuz and click “Refund” in the “Payment in Paysera” block. In Checkout Classic, refund the money in your Paysera account and change the order status yourself. The customer gets no refund email from the store.
Where to find it and who has access
- Menu
- Directories → Operations → Store settings → “Checkout & payment” → Paysera
- Access rights
- the “Store settings” window in group permissions; refunds — the “Payment operations: refund, hold, credit” permission
- Prepare
- a contract with Paysera, a project in your Paysera account, the keys of the chosen version
Related topics
- If you need to understand how the store settings window works — Store settings.
- If you also sell in Ukraine — How to accept LiqPay payments in your store.
- If you need to process a paid order in Elbuz — Customer order.
