↑↓ selectEnter openEsc close

    1. Elbuz

    How to accept RozetkaPay payments in your store

    4 min readUpdated

    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.

    1. Open the module screen. “Store settings” → “Checkout & payment” → the RozetkaPay card.
    2. Turn off “Test mode” in the “Connection” block. It is on by default.
    3. Enter the “Login” and “Password” from the RozetkaPay email.
    4. Turn on the “Enabled” switch at the top of the screen and click “Save”.
    RozetkaPay module screen: header with mode badge, the Connection block with test mode switch and login field, and the status column on the right
    1Enabled switch
    2Test mode switch
    3Login field
    4Mode badge
    1. Enabled — shows RozetkaPay to customers after you save.
    2. Test mode — test keys and payments without real money; turn it off before selling.
    3. Login — the login issued by RozetkaPay; the fields shown belong to the current mode.
    4. 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

    1. 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.
    2. 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”.
    3. Place an order on the site, choose “Card payment via RozetkaPay” and pay with a test card from the RozetkaPay documentation.
    4. The order history shows “RozetkaPay: paid … [TEST]”.
    5. 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 paymentWhat happens to the moneyWho it suits
    Off (default)Charged right awayGoods in stock, shipped right away
    OnBlocked on the card; you capture it or release the hold with a button in the orderThe 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.

    FieldWhen it is set
    PaidThe 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
    RefundedA 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:

    ButtonWhat it does
    RefundReturns all or part of the amount to the customer: the amount field is prefilled with the balance; for a partial refund, enter less
    Capture holdCharges the blocked amount, or less if some goods are unavailable. RozetkaPay returns the rest of the hold to the customer
    Release holdCancels the block, and the money goes back to the customer
    Refresh statusFetches 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 seeWhyWhat 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

    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