LiqPay works right at checkout: the customer pays by card, Apple Pay or Google Pay, and the order becomes paid automatically. Just enter two keys from your LiqPay account in the Elbuz store settings.
When you need this:
- Card payments online — money goes to your account, the status updates itself.
- The supplier ships — a hold blocks the money until you confirm the order.
- Pricey appliances get ordered and not collected — a prepayment takes only part online.
- You need a fiscal receipt — the LiqPay software cash register (PRRO) issues and emails it.
Where to start: “Store settings” → “Checkout & payment” → LiqPay → keys and “Enabled”.
What LiqPay payments can do
- Take payments on the checkout page — card, Apple Pay, Google Pay, Privat24, LiqPay wallet, QR code.
- Hold — the money is blocked on the card and charged after you confirm.
- Set the order status on its own — paid, hold, confirmed, refunded, canceled.
- Take a prepayment — a percentage or a fixed amount, the rest on delivery.
- Take money to a second account — a separate payment method with other keys.
- Issue fiscal receipts via the LiqPay cash register.
How to connect LiqPay
You need a contract with LiqPay as a sole proprietor or a company, and a shop created in your LiqPay account. Until LiqPay activates the shop, only test payments go through.
- Get the keys. In your LiqPay business account (liqpay.ua), open your shop's settings: the public and private keys are there. The private key is secret — never send it to anyone.
- Open the module screen. “Store settings” → the “Checkout & payment” section → the LiqPay card.
- Enter the keys in the “Connection” block: “Public key” and “Private key”.
- 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
LiqPay row2
Module status mark- The LiqPay row — opens the LiqPay setup screen.
- The status mark next to the name — shows whether shoppers can see this payment method and whether the latest changes have reached the store.
1
Enabled switch2
Public key3
Private key4
Still to set up5
Module state- Shows LiqPay to shoppers after you save.
- The public key from your LiqPay account.
- The secret key: after saving only a “set” mark is shown, never the key itself.
- What is still missing for the payment to work.
- The module state in the store.
The payment currency must be one of the store currencies, and for orders in zloty or pounds, so must the hryvnia. Otherwise LiqPay doesn't appear at checkout.
An enabled module won't save without keys: the field shows “Required — the module will not work without it”. The private key isn't shown after saving — the field only tells you a key is set. To change the key, enter a new one.
You don't need to enter anything in your LiqPay account: the module sends the address for payment notifications with every payment itself.
What else isn't set up appears on the right, in the “Still to set up” card. How the window works in general is covered in “Store settings”.
What the customer sees and for which orders
The customer picks LiqPay among the payment methods, confirms the order and clicks “Pay”. After paying, they see a short “Checking payment status...” page, then the usual order success page.
If the payment fails, the customer sees “Payment Error” with a “Continue” button: they can try again or choose another method.
The “How the customer pays” block sets how the payment looks:
| Field | What it does | Default |
|---|---|---|
| Payment method name | The name in the list of payment methods, separately for each language | “LiqPay (Card, Apple Pay, Google Pay)” |
| What the customer can pay with | Bank Card, LiqPay Wallet, Privat24, Apple Pay, Google Pay, QR Code | nothing ticked — everything LiqPay offers your shop |
| Where payment opens | “LiqPay page” — the customer goes to the LiqPay site and comes back; “Widget on your site” — the payment form on your page | LiqPay page |
| Widget look | Widget only: “Standard”, “Embedded in the page” or “Pop-up window” | Standard |
| Payment currency | “As in the order”, or hryvnias, dollars or euros. An order in another currency (zloty, pounds) is paid in hryvnias at the store rate | As in the order |
| Payment page language | “Site language” — English for the English version of the site, Ukrainian for all others; or “Ukrainian” or “English” | Site language |
For which orders to show it
The “Where to show” block limits who sees LiqPay:
- “Minimum order total” and “Maximum order total” — the total range,
0means no limit. If the maximum is less than the minimum, the screen won't let you save. - “Geo zone” — the payment is shown only to customers with an address in this zone; “All zones” — to everyone.
- “Position in the payment list” — a smaller number goes higher.
Hold and order statuses
Charge right away or block the money
This is the “When to charge” field in the “How the customer pays” block.
| When to charge | What happens to the money | Who it suits |
|---|---|---|
| Right away | Charged immediately | Goods in stock, shipped right away |
| After you confirm (hold) | Blocked on the card; charged when you confirm the payment | The supplier ships the goods, or stock has to be checked |
With a hold, the “Order statuses” block shows “Money blocked (hold)” and “Hold confirmed”. By default they are set to “Processed” and “Processing”.
Stores set up earlier may have “Do not change” there. Then the right side shows “The “Hold” and “Confirmed” statuses are not set, so after a hold the order is left without a status”. Choose the statuses (below).
“Money blocked (hold)” is the same as “Paid”? The right side shows “The “Paid” and “Hold” statuses are the same, so a hold cannot be told apart from a payment”.
A hold lasts a limited time: after that the bank lifts the block itself and the money goes back to the customer. The exact period is in the LiqPay terms. Confirm the hold as soon as you have the goods.
Which statuses are set
The store sets the status itself when LiqPay reports an event. You choose which ones in the “Order statuses” block. By default, “Awaiting payment” is “Pending”, “Paid” is “Processing”, and “Payment failed” is “Canceled”.
1
Paid2
Payment failed3
Money blocked (hold)4
Money refunded- Set when the payment went through; test payments get it too.
- The payment was not confirmed, so the order is canceled.
- The money is blocked on the card and waits for your confirmation.
- The money was returned to the shopper.
| Field | When it is set |
|---|---|
| Awaiting payment | A prepayment was made, the rest is paid on delivery. The module treats such an order as not paid yet |
| Paid | The customer paid the full amount. A test payment too |
| Payment failed | The customer came back from the payment, but LiqPay never confirmed it (the module waits about 20 seconds) |
| Money blocked (hold) | The money is blocked and waits for your confirmation. The same status applies while the bank waits for the customer's confirmation code |
| Hold confirmed | You confirmed the hold and the money was charged |
| Money refunded | The money was returned to the customer |
The hold fields are shown only when “When to charge” is “After you confirm (hold)”. For them and for “Money refunded” you can choose “Do not change”: then the order stays as it was. “Hold confirmed” and “Money refunded” are set when LiqPay notifies the store about the operation.
Until LiqPay confirms the payment, the order stays unconfirmed and doesn't count as new. The payment status is set only if the payment amount and currency match the current order total.
Prepayment and a second account
These are two separate payment methods next to the regular LiqPay: “LiqPay — prepayment” and “LiqPay — additional”. Both work only when the main LiqPay is set up.
Their screens appear in the “Checkout & payment” section once the method is installed in the store. No screen — Elbuz support connects the method.
Prepaying part of the total
The customer pays part online and the rest on delivery. Above the payment button they see, for example, “Prepayment 10%: 1500 UAH” and “Remaining amount: 13500 UAH”.
- “How the prepayment is counted” — “Percent of the order” or “Fixed amount”. “Prepayment size” — a percentage (0.01 to 100) or an amount in the store's main currency.
- “Minimum prepayment” and “Maximum prepayment” — the prepayment limits. 10% of UAH 500 is UAH 50, but with a minimum prepayment of 200 the customer pays UAH 200. A prepayment is never more than the order total. The limits are also in the store's main currency; if the customer pays in another one, the module converts at the store rate.
- “Minimum Order Amount” and “Maximum order amount” — which orders see the method.
0— all of them.
After the prepayment, the order gets the status from the main module's “Awaiting payment” field. Keys, currency and statuses also come from the main LiqPay. A prepayment doesn't produce a receipt.
In your LiqPay account, the payment goes under the order number with _prepay: order 123 — payment 123_prepay.
A second account: “LiqPay — additional”
One more LiqPay payment method with its own “Public key” and “Private key”. Money for these orders goes to another shop in LiqPay — for example, a second sole proprietor or a partner.
Only the keys, the name (per language; empty — “LiqPay (Additional)”), “Geo zone” and the position in the payment list are set separately. Currency, language, methods, charge mode, statuses, fiscal receipts and total limits come from the main one.
Fiscal receipts via the LiqPay software cash register
If a software cash register (PRRO) is connected in LiqPay, the store sends the order contents along with the payment. LiqPay issues a fiscal receipt and emails it to the customer at the order's email address.
- Connect the cash register in your LiqPay account and add all the products you sell to it. Each one gets its own LiqPay ID (a number).
- If shipping is paid, add shipping to the cash register as a product too, in the products list of the PRRO section of your LiqPay account.
- In the “Fiscal receipts” block, turn on “Issue fiscal receipts”. The “Delivery ID in the LiqPay register” field appears below — enter the shipping ID and click “Save”.
- Send Elbuz support a “product (name or SKU) — LiqPay ID” list. Support links the store's products to the cash register. It can also export your product list so you only fill in the IDs.
1
Issue fiscal receipts2
Delivery ID in the LiqPay register- Turns on fiscal receipts through the LiqPay software cash register; the delivery ID field appears after enabling.
- ID of the delivery set up in the LiqPay register as a product; 0 means paid delivery will not appear on the receipt.
A receipt is issued only if every product of the order is in the table. If one is missing, the payment goes through but there is no receipt. Add each new product to the LiqPay cash register right away and pass its ID to support.
The receipt total equals the payment. Shipping is a separate line, and discounts — a coupon, bonus points, a gift certificate — are spread over the products to the last kopiyka.
The receipt will list only the products, without shipping or discounts, in two cases:
- shipping is paid, but “Delivery ID in the LiqPay register” is
0; - the order has other amounts, such as tax or a surcharge for the payment method.
The first case is flagged on the right: “Fiscal receipts are on, but the “Delivery ID in the LiqPay register” is not set — paid delivery will not appear on the receipt”.
The cash register in Elbuz itself (Vchasno.Kasa, Checkbox) issues receipts for link payments and manual ones: PRRO cash registers in Elbuz.
Refunds, hold confirmation, paying the balance
To confirm a hold, refund all or part of the amount, or view payment details, contact Elbuz support: send the order number and what to do. Refunding a hold means lifting the block. Once LiqPay reports the operation, the order gets the status from the “Hold confirmed” or “Money refunded” field.
The customer can pay the balance after a prepayment, or pay for an order taken by phone, via a link. You create it in the order card in Elbuz with the “Payment link” button, for the unpaid amount. More: Payment links.
A site order arrives in Elbuz as a “Customer order” document. The payment type is “Bank card” for the main LiqPay and “LiqPay payment” for the prepayment and additional ones. Once there are orders through the main LiqPay, the screen header shows the last 30 days: count, total, average order value and the share of canceled or refunded ones.
How to check with a test payment
- Get the test keys in your LiqPay account — they start with
sandbox_. Enter them in the “Connection” block and save. - Place an order on the site for yourself, choose LiqPay and pay with a test card from the LiqPay documentation. No money is charged.
- Check that the order got the status from the “Paid” field and arrived in Elbuz.
- Replace the keys with the live ones and save.
A test payment also sets the paid status. Before launch, make sure in your LiqPay account that the shop is active and that the module has the live keys.
Scenarios
Electronics: charge only after checking stock
“When to charge” — “After you confirm (hold)”. Keep the default hold statuses or choose your own so that “Money blocked (hold)” isn't the same as “Paid”.
The item is in stock — confirm the hold through support. The item isn't available — the hold is lifted with a refund, and the money is unblocked.
Home appliances: small items in full, large ones with a prepayment
In the main LiqPay, “Maximum order total” is 15000. In “LiqPay — prepayment”, “Minimum Order Amount” is 15000, “How the prepayment is counted” is “Fixed amount”, and “Prepayment size” is 500. The customer pays for a kettle in full, and for a fridge — UAH 500 up front and the rest on delivery.
Coffee from a phone: one-tap payment
“What the customer can pay with” — Apple Pay, Google Pay and Bank Card. “Where payment opens” — “Widget on your site”, “Widget look” — “Embedded in the page”. The payment form opens on your page, with no redirect to another site.
Products and services under different sole proprietors
The main LiqPay has the first sole proprietor's keys and the name “By card: products”. “LiqPay — additional” has the second one's keys and the name “By card: services”. The customer chooses, and the money goes to the right account.
What to do when payments don't work
| What you see | Why | What to do |
|---|---|---|
| The customer doesn't see LiqPay at checkout | The module is off, the keys aren't set, the total is out of range, the address isn't in the zone, or the payment currency isn't among the store currencies | Check “Enabled”, the keys, “Minimum order total”, “Maximum order total”, “Geo zone” and “Payment currency”, then “Save” |
| The payment went through, but the status didn't change | The keys in the module don't match your LiqPay account, or no statuses are chosen | Paste the keys again and check the “Order statuses” block. Still not working — Elbuz support will check the request log |
| The payment is successful in your LiqPay account, but the order in Elbuz has no paid status | The payment amount or currency doesn't match the order total: the customer paid an old form and then changed the cart, or paid another way | Compare the payment amount in your LiqPay account with the order total and decide: extra payment, refund or order change. Not clear — Elbuz support will check the request log |
| The payment went through, but there is no receipt | One of the products is missing from the cash register table, or the LiqPay ID doesn't match | Send Elbuz support the order number: they will check the table and the log |
| “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 the customer choose between full payment and prepayment?
Yes, if both methods are on and the order total fits the limits of both.
What happens if I turn the module off?
LiqPay disappears from checkout. The keys and settings are kept: turn it back on and everything is in place.
Why isn't an unpaid order in the list?
Until LiqPay confirms the payment, the order is unconfirmed. If the customer came back without paying, it gets the status from the “Payment failed” field.
Do payments work if the site is password-protected?
LiqPay notifications won't reach such a site. The module checks the payment itself when the customer returns from LiqPay, but it's more reliable when the site is open.
The zone I need isn't in the “Geo zone” list — what do I do?
Elbuz support creates the zone, for example “Ukraine”. Then choose it in the “Where to show” block.
Where to find it and who has access
- Menu
- Directories → Operations → Store settings → “Checkout & payment” → LiqPay
- Access rights
- the “Store settings” window in group permissions
- Prepare
- a contract with LiqPay, a shop in your LiqPay account, the public and private keys
Related topics
- If you need to understand how the store settings window works — Store settings.
- If the customer wants to pay the balance or ordered by phone — Payment links.
- If you issue receipts with the cash register in Elbuz — PRRO cash registers in Elbuz.
