WayForPay works right after checkout: the customer goes to the WayForPay page, pays by card, Apple Pay or Google Pay, and the order becomes paid automatically. All you need is the merchant login and secret key from your WayForPay account.
When you need this:
- Card payments on your site — money goes to your WayForPay account, the status updates itself.
- No contract yet, but payments need checking — test mode pays without real money.
- Stock has to be checked first — a hold blocks the money, charged after you confirm.
Where to start: “Store settings” → “Checkout & payment” → WayForPay → login, key and the “Enabled” switch.
What WayForPay payments can do
- Take payments after checkout — Visa, Mastercard, Apple Pay, Google Pay on the secure WayForPay page.
- Check payments without a contract — test mode, no money is charged.
- Hold — the money is blocked on the card and charged after you confirm.
- Set the order status on its own — paid, hold, refunded.
- Refund money and capture holds — in full or part of the amount.
How to connect WayForPay
You need a contract with WayForPay and a merchant (shop) in your WayForPay account. Before the contract, you can check payments in test mode.
- Get the credentials. In your WayForPay account: “Store settings” → “Your store” → the “Merchant details” block. The Merchant Login and Merchant Secret Key are there. The key is secret — never send it to anyone.
- Open the module screen. “Store settings” → the “Checkout & payment” section → the WayForPay card.
- Turn off “Test mode” in the “Connection” block. It's on by default.
- Enter “Merchant login” and “Merchant secret key”.
- Turn on the “Enabled” switch at the top of the screen and click “Save”. “Saved and applied in the store” appears at the bottom.
1
WayForPay card2
Status mark- Opens the WayForPay setup screen.
- Shows whether shoppers see this payment method and whether the latest changes have reached the store.
1
Enabled switch2
Test mode3
Merchant login4
Merchant secret key5
Still to set up6
Mode- Shows WayForPay to customers once saved.
- Payment goes through a test merchant and no money is charged; turn it off before selling.
- Merchant login from the WayForPay cabinet.
- Merchant secret key: after saving it is not shown, only a mark that it is set.
- What is still missing for the payment to work.
- Whether the store is in test or live mode.
An enabled module in live mode won't save without the login and key: the field shows “Required — the module will not work without it”. The key isn't shown after saving — you only see that it's set. To change it, click “Replace” and enter a new one.
Store domain
Leave “Store domain” empty if the WayForPay merchant is registered to your site's domain. Otherwise enter the domain from your WayForPay account — just the name, for example shop.com.ua, without https:// or slashes.
Notification address
The “Connection” block shows the “Notification address”. The module sends it with every payment itself — you don't need to enter anything in your WayForPay account.
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”.
How to check payments without a contract
Test mode runs payments through the public WayForPay test merchant: no contract needed, no money charged. While it's on, your login and key aren't used.
- Turn on “Test mode” and “Enabled”, click “Save”.
- Place an order on the site for yourself and choose “Card payment via WayForPay”. Above the payment step you'll see “Test mode: no money is charged, pay with a test card.”
- Pay with a test card from the WayForPay docs — “Test details”.
- Check that the order got the status from the “Paid” field and arrived in Elbuz.
- Turn off “Test mode”, enter the login and key, save.
Don't sell in test mode. Anyone can find the test cards: orders get “paid” without real money, and their status becomes paid.
While the mode is on, the right side shows “Test mode is on — no money is charged. Turn it off before you start selling”.
Once the mode is off, test payments no longer change orders.
What the customer sees and for which orders
In the payment list, the customer sees “Card payment via WayForPay” with a note about Visa, Mastercard, Apple Pay and Google Pay. After confirming the order — a short “Opening the WayForPay payment page…” and the payment page itself with the list of products.
- Paid — returns to the order success page.
- Came back from WayForPay without paying — lands at checkout with “The payment was not completed. Try again or choose another payment method.” and the reason from WayForPay. The cart and details are kept.
- The payment page didn't open — “Could not open the payment page…” and a “Pay” button to try again.
Each attempt is a separate WayForPay payment starting with the order number: order 123 — payment 123-…. A retry doesn't create an extra order. The payment page is in Ukrainian, English or Russian to match the site language; for other languages WayForPay picks the language.
Payment currency
“Payment currency” — UAH, USD or EUR, UAH by default. The order total is converted into it at the store rate.
This currency must be active in the Elbuz “Currencies” directory and have a rate — then it exists in the store. If the store doesn't have the currency, WayForPay isn't shown. More: Exchange rates in Elbuz.
For which orders to show it
- “Geo zone” — the payment is shown only for addresses in this zone; “All zones” — for all of them.
- “Sort order” — the position in the payment list, a smaller number goes higher.
WayForPay has no order total limits: the method is shown for any amount.
Hold and order statuses
Charge right away or block the money
This is the “Charge mode” field in the “Payment” block.
| Charge mode | What happens to the money | Who it suits |
|---|---|---|
| Charge immediately | Charged right away | Goods in stock, shipped right away |
| Hold the funds, charge later | Blocked on the card; charged when you confirm the payment | The supplier ships the goods, stock has to be checked |
WayForPay enables holds for each merchant separately — agree on it with WayForPay before choosing the second mode. The block lasts up to 20 days (the WayForPay limit), so capture the hold as soon as you have the goods.
Which statuses are set
The store sets the status itself when WayForPay confirms an event. You choose which ones from the site statuses in the “Order statuses” block.
1
Paid2
Funds on hold3
Refunded- Set when payment succeeds or a hold is confirmed.
- Money is blocked and awaits confirmation; the field appears only with the “block funds, charge later” mode.
- Money fully returned or the hold released.
| Field | When it is set | Default |
|---|---|---|
| Paid | The payment went through or you captured the hold | Processing |
| Funds on hold | The money is blocked and waits for your confirmation | Pending |
| Refunded | The full amount was refunded or the hold was released | Refunded |
For “Refunded” you can choose “Do not change” — then the order keeps its status after a refund. “Paid” and “Funds on hold” have no such option: without a status, a paid order won't be confirmed.
The customer gets the order email when the payment goes through or the money is blocked. A captured or released hold and a full refund also change the status — the customer gets a status change email. A partial refund and “Do not change” in “Refunded” send no email.
“Paid” equals “Funds on hold”? The right side shows “The “Paid” and “Funds on hold” statuses are the same, so a hold cannot be told apart from a payment”.
Until the customer pays, the order stays unconfirmed and doesn't count as new. There's no separate status for a failed payment: the order just waits, and the customer can pay it again.
The status is set only if the payment amount and currency match the current order total. Otherwise the status won't change, even though the payment went through in your WayForPay account.
Refunds and holds in the order card
A site order arrives in Elbuz as a “Customer order” document with the “Bank card” payment type. Its card has a “Payment in WayForPay” block. It shows the payment state, the amount, how much was captured and refunded, how much can still be refunded, and every payment attempt.
Only the buttons available for the order right now are shown:
| Button | What it does | Status after |
|---|---|---|
| Refund | Refunds all or part of the amount: the amount field is already filled with the balance, enter a smaller one for a partial refund | Full — from the “Refunded” field, partial — unchanged |
| Capture hold | Charges the blocked amount, or a smaller one if some goods are missing | From the “Paid” field |
| Refresh status | Fetches the payment state from WayForPay if the notification didn't arrive. Repeating it duplicates nothing | According to the payment state |
There's no “Release hold” button for WayForPay: WayForPay releases an uncaptured hold itself when the block expires. You can release it earlier in your WayForPay account — the status from the “Refunded” field arrives with the notification or after “Refresh status”.
Before any money operation, the app asks for confirmation; for a refund — with the warning “This operation cannot be undone.”. The order status on the site changes the same way as after a WayForPay notification.
If 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 button again starts a new operation.
Only a user with the “Payment operations: refund, hold, credit” permission can refund money and capture holds — by default, the owner. “Refresh status” is available to anyone who can see the order.
Once there are orders through WayForPay, the module screen header shows the last 30 days: count, total, average order value and the share of canceled or refunded ones.
Fiscal receipt
The module doesn't issue fiscal receipts. Issue a receipt for such an order from its card in Elbuz with a Vchasno.Kasa or Checkbox cash register; in the receipt's “Payment method” field, choose “Online acquiring”. More: How to issue a receipt from an order.
Scenarios
Launching payments before the contract is signed
The module is on with “Test mode”. You place a few orders with a test card and see that the “Paid” status is set automatically. Once the contract is signed, you turn off test mode, enter the login and key, and save.
The supplier ships: charge after confirmation
“Charge mode” — “Hold the funds, charge later”, “Funds on hold” — “Pending”, “Paid” — “Processing”. The supplier confirms stock — click “Capture hold” in the order card, and the order becomes “Processing”. No stock — release the hold in your WayForPay account, the money is unblocked, and the order gets “Refunded”.
Customers abroad pay in dollars
“Payment currency” — USD, and the dollar is active and has a rate in the “Currencies” directory. Prices on the site are in hryvnias, while the WayForPay page already shows the amount in dollars at the store rate.
What to do when payments don't work
| What you see | Why | What to do |
|---|---|---|
| The customer doesn't see WayForPay at checkout | The module is off, the login or key isn't set, the payment currency isn't in the store, or the address isn't in the geo zone | Check “Enabled”, the “Connection” block, “Geo zone” and the currency in the “Currencies” directory |
| A signature or domain error on the WayForPay page | The key belongs to another merchant, or the domain doesn't match your account | Replace “Merchant secret key”, check “Store domain” |
| The payment went through, but the status didn't change | The WayForPay notification didn't reach the site, and the customer didn't return to the site after paying | Click “Refresh status” in the order card — the paid order will be confirmed. Otherwise WayForPay retries the notification for up to 4 days |
| The payment went through in your WayForPay account, but the amount differs from the order and the status didn't change | The customer paid an old attempt and then changed the cart | Check the payment in your WayForPay account and decide: extra payment, refund or order change |
| The amount on the payment page differs from the cart | “Payment currency” differs from the site currency, and the amount is converted at the rate | Check the rate in the Elbuz “Currencies” directory or set “Payment currency” to match the site |
| “The store did not accept the settings” at the bottom of the window, or “Value does not match the required format” under a field | The store didn't respond, or a field is filled in wrong, for example a domain with https:// |
Fix the highlighted fields and save. If no fields are highlighted, the changes will go with the next export |
FAQ
What happens if I turn the module off?
WayForPay disappears from checkout. The login, key and statuses are kept: turn it back on and everything is in place.
Can I change the payment method name on the site?
The module screen has no such field. Elbuz support changes the name and description.
Are installments or prepayment available through WayForPay?
No, the module takes the full order total. You can take part of the amount as a LiqPay prepayment and the rest via a payment link.
Are the WayForPay keys for payment links the same?
The credentials are the same, but they're entered separately: for the store — here, for links from Elbuz documents — in “External services”. More: Payment links.
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. A partial refund and “Do not change” send no email.
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” → WayForPay
- Access rights
- the “Store settings” window in group permissions; refunds and holds — the “Payment operations: refund, hold, credit” permission
- Prepare
- a contract with WayForPay, the Merchant Login and Merchant Secret Key from your account
Related topics
- If you need to understand how the store settings window works — Store settings.
- If the customer ordered by phone or has to pay the balance — Payment links.
- If you need a fiscal receipt for a site payment — Fiscal receipts from documents.
- If you need a hold, prepayment and receipts from the payment service — LiqPay payments in your store.
