ຄຳອະທິບາຍ
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” ແມ່ນຊອຟແວໂອເພັນຊອດ (Open Source). ບຸກຄົນຕໍ່ໄປນີ້ໄດ້ມີສ່ວນຮ່ວມໃນການພັດທະນາປລັກອິນນີ້.
ຜູ້ຮ່ວມພັດທະນາ
“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