↑↓ selectEnter openEsc close

    1. Elbuz

    How to accept WayForPay payments in your store

    5 min readUpdated

    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

    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.

    1. 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.
    2. Open the module screen. “Store settings” → the “Checkout & payment” section → the WayForPay card.
    3. Turn off “Test mode” in the “Connection” block. It's on by default.
    4. Enter “Merchant login” and “Merchant secret key”.
    5. Turn on the “Enabled” switch at the top of the screen and click “Save”. “Saved and applied in the store” appears at the bottom.
    The «Checkout & payment» section of Store settings with the WayForPay module card among the other payment modules
    1WayForPay card
    2Status mark
    1. Opens the WayForPay setup screen.
    2. Shows whether shoppers see this payment method and whether the latest changes have reached the store.
    WayForPay setup screen with the Connection block and the status column
    1Enabled switch
    2Test mode
    3Merchant login
    4Merchant secret key
    5Still to set up
    6Mode
    1. Shows WayForPay to customers once saved.
    2. Payment goes through a test merchant and no money is charged; turn it off before selling.
    3. Merchant login from the WayForPay cabinet.
    4. Merchant secret key: after saving it is not shown, only a mark that it is set.
    5. What is still missing for the payment to work.
    6. 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.

    1. Turn on “Test mode” and “Enabled”, click “Save”.
    2. 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.”
    3. Pay with a test card from the WayForPay docs — “Test details”.
    4. Check that the order got the status from the “Paid” field and arrived in Elbuz.
    5. 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 modeWhat happens to the moneyWho it suits
    Charge immediatelyCharged right awayGoods in stock, shipped right away
    Hold the funds, charge laterBlocked on the card; charged when you confirm the paymentThe 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.

    Order statuses block with Paid, Funds on hold and Refunded fields
    1Paid
    2Funds on hold
    3Refunded
    1. Set when payment succeeds or a hold is confirmed.
    2. Money is blocked and awaits confirmation; the field appears only with the “block funds, charge later” mode.
    3. Money fully returned or the hold released.
    FieldWhen it is setDefault
    PaidThe payment went through or you captured the holdProcessing
    Funds on holdThe money is blocked and waits for your confirmationPending
    RefundedThe full amount was refunded or the hold was releasedRefunded

    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:

    ButtonWhat it doesStatus after
    RefundRefunds all or part of the amount: the amount field is already filled with the balance, enter a smaller one for a partial refundFull — from the “Refunded” field, partial — unchanged
    Capture holdCharges the blocked amount, or a smaller one if some goods are missingFrom the “Paid” field
    Refresh statusFetches the payment state from WayForPay if the notification didn't arrive. Repeating it duplicates nothingAccording 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 seeWhyWhat 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

    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