Описание
morkva NovaPay integrates the NovaPay Internet Acquiring API as a WooCommerce payment method. After clicking Pay at checkout the customer is redirected to NovaPay’s hosted page, and is automatically returned to the order-received page once the transaction is finalized.
Features
- Classic checkout and WooCommerce Blocks (Cart / Checkout) support
- HPOS (High-Performance Order Storage) compatibility
- Sandbox and production environments — toggle from a single checkbox
- Status sync fallback on the order-received page — protects against missed or delayed postbacks
- Auto-redirect from NovaPay back to the shop with configurable delay (default 3s) for cleaner analytics attribution
- Order status mapping:
paidprocessing/completed,holdedon-hold,failedfailed,voided/expiredcancelled - Order meta box on the order edit screen showing: session ID, terminal, processing result, RRN, approval code, masked card PAN, card type, issuer bank
- Card, NovaPay wallet, Apple Pay and Google Pay supported through NovaPay’s hosted checkout
- Phone normalization for Ukrainian numbers (
+380…,380…,80…,0…, or 9-digit local) - Developer filters:
mrkv_novapay_client_phone,mrkv_novapay_api_base_url - Full request / response and postback logging via
WC_Logger(WooCommerce Status Logs, sourcemorkva-novapay)
Requirements
- WooCommerce 6.5 or later
- PHP 7.4 or later, OpenSSL extension enabled
- A NovaPay merchant account with API credentials (merchant ID, RSA private key, NovaPay public key)
Установка
- Upload the
morkva-novapayfolder to/wp-content/plugins/, or install the ZIP via the WordPress admin. - Activate the plugin through the Plugins screen.
- Go to WooCommerce Settings Payments NovaPay by morkva.
- Enable the gateway, paste your Merchant ID, merchant private key (PEM) and the NovaPay public key (PEM).
- Copy the Postback URL shown in the settings and paste it into your NovaPay merchant cabinet as the callback endpoint.
- (Optional) Enable Test mode while integrating with the sandbox environment.
For more context see our documentation page.
For developers
Plugin Documentation: https://morkva.helpcrunch.com/knowledge-base/uk/articles/173
Часто задаваемые вопросы
-
How do I obtain merchant credentials?
-
Through your NovaPay merchant account. The sandbox environment credentials with test keys provided in the NovaPay API documentation.
-
What’s the difference between Test mode on and off?
-
With Test mode on, API requests go to
https://api-qecom.novapay.ua(sandbox). With it off, requests go tohttps://api-ecom.novapay.ua(production). If your assigned production host differs, override it via themrkv_novapay_api_base_urlfilter. -
Does the plugin support refunds?
-
Not in this release. Refunds are planned.
-
What happens if the postback is delayed or lost?
-
On the order-received page the plugin queries NovaPay’s
get-statusendpoint and updates the order accordingly, so the status is synced even when the server-to-server postback is delayed, blocked, or lost.
Отзывы
Нет отзывов об этом плагине.
Участники и разработчики
«morkva NovaPay» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
Участники
«morkva NovaPay» переведён на 1 язык. Благодарим переводчиков за их работу.
Перевести «morkva NovaPay» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
0.2.0
- Full Internet Acquiring integration: create-session, add-payment, get-status, postback handling
- HPOS and Block Checkout compatibility declared
- Sandbox / production environment switch
- Postback v3 signature verification (RSA-SHA256 over raw body, header
x-sign-v2) - Order meta box with payment details (RRN, approval, card, terminal, processing result)
- Status sync fallback on the order-received page
- Configurable auto-redirect delay
- Ukrainian phone normalization
- Developer filters for phone formatting and API base URL
0.1.0
- Initial release