Kiero OMS knowledge base.

WayForPay is a payment provider for Kiero Store. Connect it in the Store administration, under Payments (/admin/payments). Store handles payment requests and provider notifications; OMS receives confirmed orders and operational payment results. The merchant secret and card details are not sent to OMS.

Before you start

You need owner or administrator access to the Store and your own WayForPay merchant account. This Store integration requires UAH; ensure the catalogue has prices in that currency. A different store currency makes the connection unavailable. Currency selection does not convert product prices or activate a merchant account.

Create a store in the WayForPay dashboard and complete the provider's activation requirements. Use the official activation guide for the current requirements for your account. Provider fees, settlement terms and account limits are separate from Kiero settings.

Sign in to the WayForPay dashboard.
Open Налаштування магазину → Ваш магазин → Реквізити мерчанта (Store settings → Your store → Merchant details).
Copy Merchant Login into the Store field Merchant account (Merchant Login).
Copy Merchant Secret Key into the secret-key field. This is not your dashboard password.

See the official merchant-details instructions. Never send the secret key to support or include it in screenshots, public pages or OMS order comments.

Connect and enable payments

In Store Payments, open WayForPay connection.
Enter Merchant Account and Merchant Secret Key and choose Connect.
Wait for the automatic connection check. Use Refresh connection status to read the current state; a saved connection does not require re-entering the key.
When the connection is ready, check the displayed merchant account. Confirm that you want to accept real payments through that account, then choose Enable payment acceptance.
Confirm that the page reports WayForPay as active. Until then, do not assume checkout can accept live payments.

Kiero determines the domain and technical callback parameters. The guided setup does not require manually configuring a webhook or making a test purchase. Saving a replacement account does not immediately switch existing payments; the switch follows verification and your confirmation.

What the status means

Status	Next step
Checking the account	Wait and refresh the status.
Invalid credentials	Check Merchant Login and Merchant Secret Key for the correct store.
API access denied	Contact WayForPay support with the displayed code; code 1117 indicates API access needs attention.
Account restricted	Check activation and limits in WayForPay; contact provider support if code 1118 persists.
Service verification pending	Wait for Kiero's technical acceptance; re-saving the key does not enable payments.
Connection ready	Check the account and explicitly confirm payment acceptance.
Active	The connection is enabled; actual transactions remain subject to the provider's account permissions and limits.

If the API is temporarily unavailable, refresh later. Do not repeatedly replace valid credentials to clear a temporary error.

Orders, history and refunds

After a confirmed payment, the order and payment result are passed to OMS. Returning to the store after payment is not by itself proof of success: the system must receive a verified provider result. Store Payments includes WayForPay history for a configured account.

A refund in the implemented flow requires an approved refund decision in OMS and owner confirmation in Store. An uncertain refund result must be reconciled before another attempt; do not repeat a refund blindly. See returns.

Verification status, 19 October 2026: setup, activation and refund safeguards are covered by source checks and local tests. Live payment and refund acceptance is not yet confirmed in the project documentation. Saving credentials or passing a technical check alone does not remove this limitation.

Security and help

Keep the merchant key only in the connection form. If it is exposed, replace it through WayForPay and update the Store connection. For support, provide the displayed status, merchant identifier and error code without keys or card data.