At checkout, the customer pays on the RozetkaPay page by card, Apple Pay or Google Pay, and the order becomes paid automatically. In the Elbuz store settings, just enter your RozetkaPay login and password.
When you need this:
- Card payments on your site — the status changes by itself.
- No contract yet, but you want to try — test mode uses the public test keys.
- The supplier ships — two-step payment blocks the money until you charge it in the order.
- An item came back — refund from the Elbuz order card.
Where to start: “Store settings” → “Checkout & payment” → the RozetkaPay card → login, password and “Enabled”.
What RozetkaPay payments can do
- Take payments — Visa and Mastercard cards, Apple Pay, Google Pay on the RozetkaPay page.
- Test mode — pay with a test card, without a contract and without real money.
- Hold — the money is blocked and charged after you confirm.
- Refund money and manage holds — with buttons in the order card in Elbuz.
- Check the keys itself — after saving, the screen shows whether RozetkaPay accepts them.
How to connect RozetkaPay
You need a contract with RozetkaPay (sign-up at business.rozetkapay.com). After you connect, RozetkaPay sends a login and password for the API. No email — ask RozetkaPay support for the integration login and password.
- Open the module screen. “Store settings” → “Checkout & payment” → the RozetkaPay card.
- Turn off “Test mode” in the “Connection” block. It is on by default.
- Enter the “Login” and “Password” from the RozetkaPay email.
- Turn on the “Enabled” switch at the top of the screen and click “Save”.
1
Enabled switch2
Test mode switch3
Login field4
Mode badge- Enabled — shows RozetkaPay to customers after you save.
- Test mode — test keys and payments without real money; turn it off before selling.
- Login — the login issued by RozetkaPay; the fields shown belong to the current mode.
- Mode badge — shows which mode the payment is working in right now.
Within a few minutes, the store asks RozetkaPay itself whether the keys fit. The “Connection” block then shows “RozetkaPay keys work” or “RozetkaPay rejects the keys”, with the check date and the reason.
In test mode, it's “RozetkaPay test keys work” or “RozetkaPay rejects the test keys”. No such line — the module is off, or the current settings haven't been checked yet.
Each mode has its own keys: you see the pair of the mode that is on. The password isn't shown after saving. An enabled module won't save without the login and password of the current mode.
Payments are accepted in hryvnias only. Prices in another currency are converted at the store's hryvnia rate. If the hryvnia isn't among the store currencies, RozetkaPay doesn't appear at checkout.
The “Notification address” on the screen is for reference. The module sends it to RozetkaPay with every payment itself: nothing to enter in your RozetkaPay business account.
How to check with a test payment
- Turn on “Test mode”. In “Test login” and “Test password”, paste the keys from the RozetkaPay documentation: docs.rozetkapay.com → Sandbox → Credentials, the Hosted checkout row.
- Turn on “Enabled” and save. While test mode is on, the right side shows “Test mode is on — no money is charged. Turn it off before selling”.
- Place an order on the site, choose “Card payment via RozetkaPay” and pay with a test card from the RozetkaPay documentation.
- The order history shows “RozetkaPay: paid … [TEST]”.
- Turn off “Test mode”, enter the live keys and save.
Anyone knows the test keys and cards. While test mode is on, an order can be “paid” without money. Turn it off before you start selling.
Once test mode is off, test payments no longer change orders, and operations on them in the order card don't run.
What the customer sees
- At checkout — the “Card payment via RozetkaPay” method with a hint about Visa, Mastercard, Apple Pay and Google Pay.
- After confirming — “Going to the RozetkaPay payment page…”. The payment page opens in the site language: Ukrainian, Polish or English; from the Russian version — Ukrainian, from other languages — English.
- Paid — they return to the placed order page.
- Didn't pay and came back from the payment page — they land at checkout with a message. The cart is kept, so they can pay again or choose another method.
Another payment attempt doesn't create a new order. In your RozetkaPay business account, the attempts of one order are numbered “123”, “123-2”, “123-3”; test ones — “123-t…”.
The “Where to show” block limits who sees RozetkaPay: “Geo zone” (“All zones” by default) and “Sort order” — the position in the payment list.
Hold and order statuses
| Two-step payment | What happens to the money | Who it suits |
|---|---|---|
| Off (default) | Charged right away | Goods in stock, shipped right away |
| On | Blocked on the card; you capture it or release the hold with a button in the order | The supplier ships the goods, or stock has to be checked |
The store sets the status itself when RozetkaPay reports an event. You choose which ones from the site statuses in the “Order statuses” block.
| Field | When it is set |
|---|---|
| Paid | The payment went through or the hold was captured. A test payment too |
| Funds blocked (hold) | The money is blocked and waits for confirmation. The field is shown only when two-step payment is on |
| Refunded | A full refund or a released hold. “Do not change” — the status stays, and a note appears in the history |
A partial refund doesn't change the status — only the history note “RozetkaPay: partial refund, refunded in total …”.
Until the customer pays, the order stays unconfirmed and doesn't count as new.
“Paid” or the hold status is set only if the payment amount equals the current order total. Otherwise the history shows “RozetkaPay: paid …, but the order total is now … The status is not changed: check the payment in the RozetkaPay cabinet.”
Refunds and holds 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 RozetkaPay” block: payment status, amount, captured and refunded sums, what can still be refunded. Below are all payment attempts with their RozetkaPay number.
Only the buttons available to the order right now are shown:
| Button | What it does |
|---|---|
| Refund | Returns all or part of the amount to the customer: the amount field is prefilled with the balance; for a partial refund, enter less |
| Capture hold | Charges the blocked amount, or less if some goods are unavailable. RozetkaPay returns the rest of the hold to the customer |
| Release hold | Cancels the block, and the money goes back to the customer |
| Refresh status | Fetches the payment status from RozetkaPay if the notification didn't arrive |
Before every money operation the program asks for confirmation; for a refund and a hold release, with the warning “This operation cannot be undone.”. The order status on the site changes just as after a RozetkaPay notification, and a note with the result appears in the order history in Elbuz.
The store didn't respond — a “Retry” button appears under the message: it repeats the same operation, and the money doesn't move a second time. Clicking the operation button again is a new operation.
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.
Scenarios
Home appliances from a supplier's warehouse
Turn on “Two-step payment”. The customer's money stays blocked until the supplier confirms stock. In stock — “Capture hold”; not available — “Release hold”, and the customer doesn't wait weeks for a refund.
Electronics: part of the order ran out
With two-step payment, click “Capture hold” and enter the amount of what you ship. The rest of the hold goes back to the customer automatically.
Clothing with frequent returns
Turn two-step payment off: the customer pays right away. They returned one item — “Refund” for that item's amount, and the order status doesn't change.
The store also sells in Poland
Limit RozetkaPay with the “Geo zone” “Ukraine”. Polish customers see their own payment methods, and RozetkaPay is shown only for hryvnia orders in Ukraine.
What to do when payments don't work
| What you see | Why | What to do |
|---|---|---|
| The customer doesn't see RozetkaPay at checkout | The module is off, there are no keys for the current mode, the address isn't in the “Geo zone”, or the store has no hryvnia currency | Check “Enabled”, the keys, the “Geo zone” and the store currencies, then “Save” |
| “RozetkaPay rejects the keys” or “…the test keys” | The keys were copied only partly or for the wrong mode: test keys work only in test mode, live keys only without it | Paste the login and password again, without spaces, and save. The result comes in a few minutes |
| The payment went through, but the status didn't change | The RozetkaPay notification didn't arrive, for example because the site has no HTTPS | Click “Refresh status” in the order card. The status also updates when the customer returns to the site |
| A history note that the paid amount differs from the order total | The customer paid an old attempt and then changed the cart | Check the payment in your RozetkaPay business account and decide: extra payment, refund or order change |
| An operation on a test payment doesn't run | Test mode is already off | Test payments live only in test mode; there is no real money in them |
FAQ
Can I accept payments in euros or dollars?
No, RozetkaPay accepts hryvnias only. An order total in another currency is converted at the store's hryvnia rate.
Do I need to enter anything in my RozetkaPay business account?
No. The module sends the notification address with every payment itself.
What happens if I turn the module off?
RozetkaPay disappears from checkout. The keys and settings are kept: turn it back on and everything is in place.
Does the customer get an email after a refund?
Yes, if the status changes to the one chosen in the “Refunded” field: the customer gets the usual status change email. For a partial refund and with “Do not change”, there is no email — only a note in the order history.
The customer clicked “Pay” twice — will there be two payments?
No. While the payment page is still valid, another attempt opens the same one; a new attempt gets its own number and doesn't create a new order.
Where to find it and who has access
- Menu
- Directories → Operations → Store settings → “Checkout & payment” → RozetkaPay
- Other entry points
- the customer order card — the “Payment in RozetkaPay” block
- Access rights
- the “Store settings” window; for refunds and holds — “Payment operations: refund, hold, credit”
- Prepare
- a contract with RozetkaPay, the API login and password, the hryvnia among the store currencies
Related topics
- If you need to understand how the store settings window works — How to set up an Elbuz CMS store and its modules in the app.
- If you need a partial prepayment or a fiscal receipt — How to accept LiqPay payments in your store.
- If the customer wants to pay the balance or ordered by phone — Payment links.
