Qliro for WooCommerce
| 开发者 | krokedil |
|---|---|
| 更新时间 | 2026年9月7日 20:01 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv3 or later |
| 版权网址: | 版权信息 |
详情介绍:
Qliro for WooCommerce connects your WooCommerce store to the Qliro Checkout. Once configured, customers can complete their purchase using the payment methods offered by Qliro, such as invoice, partial payment, card, and direct bank transfers, directly from your checkout page.
The plugin replaces the standard WooCommerce checkout with the embedded Qliro Checkout iframe, and synchronises the WooCommerce order with Qliro throughout the order lifecycle, including capture, cancel, and refund.
Features
- Embedded Qliro Checkout on the WooCommerce checkout page.
- Order management from the WooCommerce admin: capture, cancel, and refund orders in Qliro.
- Support for WooCommerce Subscriptions.
- Support for Pay for order.
- Support for gift cards.
- Support for integrated shipping with Ingrid and nShift via the Krokedil Shipping Connector.
- Support for High-Performance Order Storage (HPOS).
- Country selector for multi-market stores.
- Payment widget and banner widget shortcodes for product and cart pages.
- WooCommerce 5.0 or higher.
- PHP 7.4 or higher.
- A merchant agreement with Qliro. Visit qliro.com to sign up.
- Upload the plugin folder to the "/wp-content/plugins/" directory, or install the plugin through the WordPress plugins screen.
- Activate the plugin through the "Plugins" menu in WordPress.
- Go to WooCommerce -> Settings -> Payments and configure your Qliro settings.
- Read more about the configuration process in the plugin documentation.
屏幕截图:
常见问题:
Where do I get a Qliro merchant account?
You need to sign a merchant agreement with Qliro. Visit qliro.com to get started.
Where can I find the documentation?
The plugin documentation is available at docs.krokedil.com/qliro-for-woocommerce.
Where do I get support?
Support for this plugin is handled via support@qliro.com.
更新日志:
2026-09-07 - version 2.4.0
- Feature - Customers can now change the payment card on a subscription, and are told if the card was not registered.
- Fix - Selecting a shipping option or pickup point whose address contains an apostrophe no longer causes the selection to be dropped in WooCommerce,which resulted in mismatching totals and orders registered with the wrong shipping method.
- Fix - A shipping option selected in the Qliro iframe just before the purchase is completed is now always applied to the WooCommerce order, instead of the order potentially being placed with the previously selected option.
- Feature - You can now apply discounts to captured orders.
- Enhancement - Scheduled actions related to an order are now shown in the order metabox, to make troubleshooting easier.
- Enhancement - The return fee on refunds is now explained in the order admin, and shown to the customer in refund emails and on the My Account page.
- Enhancement - Strengthened the permission and request validation checks on the Qliro order actions in the WooCommerce admin.
- Enhancement - The refused and on-hold checkout callbacks are now confirmed against the Qliro API before the order status is changed, and the third-party notifications endpoint now verifies that its callback token was issued for the order the notification refers to.
- Enhancement - Products whose SKU contains characters that Qliro does not accept are now flagged when the product is saved, and customers get a clear message in the checkout.
- Fix - Fixed the confirmation page showing up blank after a completed purchase on some server setups.
- Fix - Fixed failed subscription renewals staying On hold, which left WooCommerce Subscriptions unable to retry them.
- Fix - Fixed subscription renewals failing to retry after a declined payment. Renewal payments are now created with a temporary reference that is replaced by the order number once the payment goes through, so a failed renewal can be retried as many times as needed.
- Fix - Fixed renewals that cover several subscriptions being charged once per subscription, which could leave extra payment reservations at Qliro.
- Fix - Fixed a declined subscription renewal never being retried. When "Retry Failed Payments" is enabled in the WooCommerce Subscriptions settings, a renewal that Qliro declines now has the store's retry rules applied to it, so the renewal order is moved on and retried according to those rules instead of being left as failed.
- Fix - Fixed a PHP warning that was logged during checkout when no shipping method had been selected yet, which happens when the store hides shippingcosts until an address is entered.
- Enhancement - Improved user-facing error handling with clearer notices containing more descriptive information.
- Enhancement - Improve the validation of the callbacks from Qliro when storing card tokens and processing notifications.
- Enhancement - Hardened the save-card and subscription preauthorization callbacks: the order is now identified from a signed per-order token in the callback URL rather than the request body, and the saved card details and preauthorization outcome are re-fetched from the Qliro API instead of being trusted from the callback body.
- Enhancement - Added an
x-platform: WooCommerceHTTP header to all requests sent to the Qliro API.
- Fix - Fixed an issue where a subscription renewal declined by Qliro could still be processed as a successful payment. Failed renewals are now correctly handled and marked as payment failed in WooCommerce.
- Fix - Resolved a checkout error introduced by WooCommerce 10.8.0, where shipping phone became a required field. The shipping phone value is now populated correctly.
- Tweak - Fixed an edge case where an empty cart could trigger an unnecessary Qliro order creation on the checkout page, as a safeguard for when WooCommerce's built-in redirect does not occur.
- Fix - Fixed an issue that could cause a fatal error during checkout when a zero-amount fee was applied to the cart.
- Tweak - Changed sync button text from 'with qliro' to 'to qliro'.
- Fix - Added the request URL as the 2nd parameter to the 'http_headers_useragent' filter which is required for other plugins that hook onto this filter that need the URL to modify the user agent string accordingly.
- Tweak - Added a locking mechanism in the confirmation step to prevent a race condition that could lead to an order being processed more than once.
- Tweak - Added preauthorization processing for subscription renewal. This puts a renewal order on-hold until it has been confirmed by Qliro for further processing.
- Fix - Prevent the order from entering an invalid needs payment state when the 'qliro_check_if_needs_payment' filter is active and set to false. This would make a 'Pay' button appear on the order received page even for completed purchases.
- Enhancement - Extended logging in callback handling card tokenzation for subscription.
- Enhancement - Adds Matkahuolto as a selectable shipping Brand for Qliro shipping method instance settings.
- Tweak - The chosen payment option is now shown in the subscription's payment method description.
- Tweak - Fixes error message not shown during payment processing due to WC changes.
- Fix - Fixed a critical error when attempting to retrieve a deleted payment token on subscription renewal.
- Fix - Fixed renewal failing for virtual, downloadable subscriptions by defaulting the shipping address to the billing address when it was missing.
- Fix - Fixed an issue where integrated shipping could become out of sync with the WC pick-up point selector.
- Fix - Prevented a visible "0" from appearing in the shipping section when pickup point coordinates are zero.
- Fix - Fixed an issue where reopening a payment link for a order pay order could fail with an existing Qliro order error, leaving the original order in-process and potentially locking coupons.
- Feature - Add support for adding VAT rate to order discounts applied to the Qliro order through the admin page.
- Enhancement - Updated the design of the modal for the discount.
- Enhancement - Added more error messages for when a discount fails to be applied to a Qliro order.
- Fix - Fixed a few incorrect function names leftover from the release on WordPress.org
- Fix - Fixed an issue that could cause a callback from Qliro to cancel an order when applying a discount to it. This could happen with Trustly orders when the setting for advanced order management was enabled with a OK cancel order status set.
- Tweak - Cancel requests are no longer triggered for orders that have already been refunded.
- Bump WordPress version to to be compatible with version 1.18.1.
- Initial release of Qliro for WooCommerce on wordpress.org, compatible with version 1.15.0.
- Fix - Fixed an issue caused by not getting the correct payment transaction id before doing order management actions, such as capture, cancel or refunds that could cause errors with some Qliro payment methods in some cases.
- Feature - Added support for Upsell through payment methods like Trustly or Swish, where the customer is redirected to complete the upsell. Requires Post Purchase Upsell for WooCommerce version 4.0.0.
- Feature - Added support for refunding orders that have been captured using the partial capture functionality.
- Feature - Added a action hook and jQuery event called
qliro_customer_data_fetched, that is called when we fetch the address data from the Qliro session in the checkout. This can be used to set customer data outside of what the plugin already does. - Change - Changed the needed permissions to add a discount to a Qliro order from 'manage_woocommerce' to 'edit_shop_orders' to allow shop managers to add discounts.
- Fix - Fixed an issue where the shipping billing country was not always updated when changing the billing country field in the checkout.
- Fix - Fixed some information in the order metabox not always being correct when some transactions had a different order amount than the original order.
- Fix - Send the vat rate when shipping methods are sent as shipping options to Qliro when showing shipping selection in the Qliro checkout.
- Fix - Fixed a reference to deprecated JavaScript libraries since WooCommerce 10.3.0.
- Fix - Fixed showing the incorrect value in the order metabox for the Qliro order total when discounts had been applied, or some other cases.
- Fix - Fixed how we calculate the available amount to create a discount for, that could cause issues when fees were added to the order.
- Tweak - Improved the newsletter signup feature and added a setting for customizing the newsletter signup checkbox label.
- Tweak - Added the 'qliro_one_helper_cart_items' filter to enable customization of cart items.
- Tweak - Added the 'qliro_one_helper_order_items' filter to enable customization of order items.
- Fix - Improved compatibility with 'WooCommerce Subscriptions' by correctly handling additional subscription types, including renewals, switches, and resubscriptions.
- Fix - Corrected the display of pickup point addresses in checkout when choosing home delivery with the 'WooCommerce PostNord Shipping' plugin by Redlight Media.
- Tweak - Discounts are now applied only to products, excluding shipping costs and fees.
- Feature - Added Advanced demo mode, allowing testing of the Qliro payment solution in the store without enabling it for all customers.
- Fix - Improved the new discount feature to support all markets, with proper currency handling and translations.
- Enhancement - An admin notice is now displayed when Qliro is running in test mode.
- Enhancement - Improved handling of shipping when a separate shipping address is entered.
- Fix - Fixed a fatal error that could occur if Kernl returned a temporary update error during plugin updates.
- Feature - Added support for applying discounts to orders after purchase.
- Fix - Fixed an issue where WC Subscription renewal orders failed for auto-completed orders.
- Fix - Fixed an issue where clicking the 'Sync order with Qliro' button redirected users to a blank page after syncing.
- Feature - Added support for the 'CareOf' field.
- Feature - Added support for 'All Products for WooCommerce Subscriptions' by Woo.
- Feature - Introduced a filter to allow automatic syncing of WooCommerce orders to Qliro whenever an order is updated.
- Fix - Fixed an issue where shipping methods are re-calculated when placing an order, causing WooCommerce to default to the first shipping method available.
- Fix - Fixed an issue where the country selector was not displayed on the checkout page for guest users until the page was reloaded.
- Fix - Fixed a deprecation error related to translations.
- Fix - Resolved the checkout page layout not working as expected for some layout options.
- Feature - Added support for sending VatRate on order lines to Qliro.
- Fix - Resolved fatal error that could occur for merchants using PHP version 7.4 and below.
- Fix - Updated some spelling and dead documentation links for the Qliro settings page.
- Enhancement - Prepared the plugin for deployment to wordpress.org.
- Tweak - Slightly updated the design of the checkout template.
- Tweak - Renamed the Qliro metabox setting 'Order synchronization' to 'Order Management'.
- Feature - Added support for handling notification callbacks from Qliro after the order is placed. For now this only supports saving Ingrid shipping data when using the Qliro integrated shipping with Ingrid.
- Feature - Added the action 'qliro_notification_{event_type}_{provider}' for custom handling of Qliro notification events. 'event_type' and 'provider' are the lowercase values sent by Qliro in the notification request.
- Fix - Fixed an issue that could affect the Google Analytics tracking of the Qliro checkout.
- Fix - Fixed the refund fee text not being removed when refund amount was zero.
- Tweak - Renamed 'Order synchronization' to 'Order Management' in the Qliro order metabox.
- Feature - Redesigned the layout, structure and navigation of the settings page.
- Fix - Pay for order should now be working as expected.
- Fix - Fixed a potential fatal error that could occur if dependencies failed to install properly.
- Fix - Fixed the province data sometimes being incorrectly set on the order confirmation page.
- Fix - Fixed a potential fatal error that could occur during order management actions when the shipping option price was returned as a string that is not a valid number, caused by WooCommerce version 9.9.x.
- Enhancement - Added support for other plugins to set a description on shipping rates shown in the Qliro checkout. Supported by Krokedil Shipping Connector from version 3.16.0.
- Tweak - Added the option to include a merchant integrity policy URL link in the Qliro iframe.
- Tweak - Readme changes.
- Fix - Fixed a potential fatal error during checkout that could occur when the shipping option price was returned as a string that is not a valid number, caused by WooCommerce version 9.9.x.
- Feature - Added support for adding a return fee when making a refund on a Qliro order.
- Feature - Added a setting to automatically calculate a return fee for Qliro orders, if a refund is made when the full amount of a order line is not refunded.
- Feature - Added a setting to display a country selector on the checkout page or through the shortcode 'qliro_country_selector'.
- Enhancement - Changed so the refund with Qliro button is not shown for orders that have not been completed with Qliro, preventing the refund from causing a API error when it can't be made.
- Enhancement - Improved logging to handle situations where the remote requests returns WP_Error that is not properly logged.
- Tweak - The sync order button will now always be available on the order edit page for all Qliro orders regardless of payment method.
- Tweak - Checks if the order was paid with Qliro before showing the partial capture button on the order edit page.
- Tweak - Removed pending, refunded and failed order statuses from part of the statuses in the order management where it is not relevant.
- Tweak - Relabeling from "Qliro One" to "Qliro".
- Fix - Fixed an undefined array key warning.
- Fix - Added 'Tax status' setting for shipping method to be compatible with WooCommerce 9.7+.
- Feature - Added compatibility with the 'WooCommerce PostNord Shipping' plugin by Redlight Media.
- Fix - Fixed country sometimes being set to null in checkout, when restricting selling locations.
- Fix - Limited the max size of a log message from the frontend to 1000 characters to prevent large logs from being created.
- Fix - Include cart hash when testing if we need to update a Qliro session or not to catch changes that effects products but not the order total.
- Fix - Add a check when reading the Qliro order before submitting the WooCommerce order to ensure the Qliro order has not already been completed.
- Fix - Fixed a critical error that could occur when the merchant reference for fees was too long or included special characters.
- Fix - Fixed an undefined array key warning.
- Tweak - Improved logging by keeping track of user sessions with unique IDs.
- Feature - Added 'Type' (discount, fee, shipping) to order lines.
- Fix - Fixed an issue where free shipping coupons did not always update the order in checkout.
- Fix - Fixed an issue where a removed coupon sometimes remained in the order.
- Fix - Fixed an issue where refunds sometimes failed for pickup point orders.
- Fix - Fixed 'MerchantReference' being incorrectly set for fees.
- Fix - Fix so that negative fees are set as discounts.
- Fix - Fixed an undefined array key warning.
- Fix - Fixed a critical error that could occur while editing the checkout page.
- Feature - Added support for gift cards.
- Feature - Added support for subscriptions.
- Feature - Added support for pay for order.
- Feature - Added support for gift cards.
- Feature - Added 'qoc_order_confirmed' to enable newsletter support, together with other custom actions when a Qliro order is confirmed.
- Tweak - Allow order status 'Completed' if order is captured through portal.
- Tweak - Added redirect to 'Thank you' page if order is already completed, but user is still on the checkout page.
- Fix - Fixed PHP 8.3.0 array_sum warnings.
- Fix - Fixed missing address data from Qliro API during update.
- Fix - Fixed issue with unsetting other shipping methods.
- Fix - Fixed an issue where we would print Qliro error messages on API calls to WooCommerce on Qliro orders in some cases, causing the response to not be a valid JSON output. This could cause issues when other services tried to for example set the order status on an order placed with Qliro.
- Enhancement - Improved the error handling when placing an order in WooCommerce when the session from Qliro has expired or is missing in WooCommerce, which would cause a timeout error.
- Enhancement - When matching Ingrid shipping tax rates to WooCommerce, allow a diff of 0.1 when comparing the tax rates to avoid rounding discrepancies between the two systems. This will prevent the wrong tax rate from being used when calculating the shipping tax in WooCommerce.
- Fix - Fixed an issue when refunding an order line without specifying the order line quantity causing a division by zero error.
- Fix - Fixed an issue when refunding a shipment order line with the Ingrid integration, where metadata from the order line was not copied over to the refund order line.
- Fix - Fixed trying to access a setting before it has been saved, causing a PHP warning.
- Fix - Fixed an issue where an incorrect shipment reference was being used for Instabox integrated shipping in order management requests.
- Feature - Added support for shipping with Ingrid.
- Feature - Added support for partial capture.
- Feature - Added the 'qliro_one_enforced_juridical_type' filter for modifying the name of the cookie that refers to the customer type.
- Tweak - Tweaked the metabox's design.
- Fix - Fixed not handling Completed Qliro orders correctly if the customer landed back on the checkout page without the confirmation step being completed. The customer will now be redirected to a thankyou page for their order.
- Feature - Added the ability to flag all products as high-risk through plugin settings or individually at the product level. Flagged products may disable certain payment methods.
- Tweak - Enhanced compatibility with currency switchers by initializing a new session when the currency changes.
- Tweak - Adjusted the styling of the "Sync Order with Qliro" button.
- Tweak - Enabled the plugin to handle zero-sum orders, with an option to override via the 'qliro_check_if_needs_payment' filter.
- Fix - Resolved a critical error caused by the logger.
- Feature - Added a metabox to Qliro order pages to show information about the Qliro order in WooCommerce.
- Feature - Added a toggle to detach specific orders from the automatic order management. This is useful if you want to manually handle specific orders in WooCommerce.
- Feature - Added a sync order with Qliro button that allows you to manually sync an order with Qliro if any changes have been made to it in WooCommerce. This is not available for card payments.
- Fix - Fixed support for Finish localization by passing it correctly to Qliro's API.
- Fix - Fixed not properly clearing the current session with Qliro when the currency is changed in the store.
- Fix - Sometimes the session ID would be missing, this would result in a critical error in the AJAX when attempting to retrieve the order from Qliro. This has now been fixed.
- Fix - Fixed an issue due to undefined variable in the JavaScript.
- Feature - Support for integrated shipping with nShift using the Krokedil Shipping Connector plugin.
- Enhancement - The shipping methods in WooCommerce will be hidden until Qliro has retrieved the selected shipping option from Qliro when showing shipping options in the Qliro iFrame.
- Enhancement - Scoped the plugin dependencies for the plugin to avoid conflicts with other plugins using the same dependencies with different versions.
- Fix - Fixed support for syncing the area returned by Qliro with the region field in WooCommerce.
- Fix - Fixed an issue where some plugins used the same dependencies as Qliro but with different versions, causing a conflict and potential PHP errors.
- Feature - The plugin now supports WooCommerce's "High-Performance Order Storage" ("HPOS") feature.
- Tweak - Adjusted the timeout timer (4.5 → 29 seconds).
- Fix - Resolved string interpolation deprecation warning.
- Enhancement - Adds a log message when a timeout occurs during the order creation process.
- Feature - Adds support for delivery date (date start + date end) in shipping option displayed in checkout.
- Tweak - Adds filter qliro_one_shipping_option so other plugins can hook into shipping option about to be sent to Qliro.
- Tweak - Do not put the order to on-hold during callback handling if it already has been processed. Prevents possible issues where Trustly payments triggers two callbacks with different status simultaneously.
- Fix - Fix undefined index warning.
- Tweak - Adds timer to allow max 4.5 seconds for order creation in Woo when customer completes purchase in Qliro One. If time limit exceeds, the purchase is denied. Avoids payments in Qliro where the order is missing in Woo.
- Feature - Adds support for sending pickup points to Qliro when displaying shipping methods in the Qliro One checkout. Needs to be supported by the individual shipping method.
- Enhancement - Improved logging related to events during checkout process, when customer places the order.
- Enhancement - Improved logging related to order management & callbacks.
- Fix - Resolved an issue where the currency was incorrectly fetched from the store settings instead of the available order currency. This issue led to discrepancies when using a multi-currency plugin.
- Fix - Fixed issues with Table Rate shipping caused by shipping settings introduced in 0.6.0. If you personalized the shipping section using the feature added in 0.6.0 you may need to reapply those settings.
- Fix - Updated our JavaScript to no longer use the deprecated getOrderUpdates function from Qliros JavaScript API, but rather use the onOrderUpdated function. Resolves issues with postcode based shipping.
- Fix - Fixed an undefined index notice that happened due to missing a default value.
- Feature - You now have the ability to personalize the shipping section on the checkout page by using shipping labels. You can find these settings by navigating to WooCommerce → Shipping → Select a shipping method.
- Feature - You now have the option to show a brief introductory text in the shipping section of the payment form on the checkout page.
- Feature - You now have the convenience of placing a payment widget on the product page or any other location using the shortcode 'qliro_one_payment_widget'.
- Feature - You are now able to place a banner widget on the shopping cart page or anywhere else using the shortcode 'qliro_one_banner_widget'.
- Fix - We've resolved an issue where a JavaScript error would be triggered if a customer fails to identify themselves using the PNO after having used it for identification previously.
- Tweak - We have reorganized the settings page of Qliro One to streamline navigation and improve user experience.
- Enhancement - We have incorporated more detailed error messages to provide better clarity in case an order management action is unsuccessful.
- Feature - Added support for Table Rate Shipping plugin.
- Fix - Fixed an issue caused by relying on the WooCommece cart hash if we should update an order to Qliro or not. This caused issues with anything that did not change the totals or the contents of the cart.
- Fix - Fixed so the Qliro order id is logged with each request, making log parsing easier.
- Enhancement - The Qliro HTML snippet is now stripped from the request logs.
- Enhancement - Add order note to WooCommerce orders when a Qliro order has been placed that contain the Qliro order id.
- Feature - Added support for OnHold callbacks from Qliro.
- Tweak - Minor change to style to make the order review take up the space its allowed to take up
- Fix - Fixed an issue with adminapi endpoints containing a extra backslash causing 404 errors.
- Fix - Fixed sending a incorrect field name for MinimumCustomerAge.
- Fix - Fixed some error handling on the order confirmation page.
- Fix - Fixed an issue with order management callbacks. The confirmation string was not being passed in the URL for the callback.
- Feature - Add support for the Post Purchase Upsell for WooCommerce plugin.
- Tweak - Changed the ID of the order review in our checkout template.
- Tweak - Readme changes.
- Tweak - Readme changes.
- Initial release.