worldline-for-woocommerce
Last commit date
assets
1 week ago
inc
1 week ago
languages
1 week ago
modules
1 week ago
shared
1 week ago
src
1 week ago
vendor
1 week ago
.eslintrc.js
1 week ago
BUILD_INFO.txt
1 week ago
LICENSE
1 week ago
SECURITY.md
1 week ago
class-plugin.php
1 week ago
composer.json
1 week ago
config.php
1 week ago
package.json
1 week ago
readme.txt
1 week ago
tsconfig.json
1 week ago
uninstall.php
1 week ago
webpack.config.js
1 week ago
worldline-for-woocommerce.php
1 week ago
readme.txt
342 lines
| 1 | === Worldline Global Online Pay for WooCommerce === |
| 2 | Contributors: worldlineisv |
| 3 | Tags: woocommerce, Worldline, payments, ecommerce |
| 4 | Requires at least: 6.3 |
| 5 | Tested up to: 6.9 |
| 6 | Requires PHP: 7.4 |
| 7 | Stable tag: 2.5.22 |
| 8 | License: GPLv2 |
| 9 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 | |
| 11 | == Description == |
| 12 | |
| 13 | == Worldline GoPay for WooCommerce == |
| 14 | |
| 15 | Accept credit/debit cards, digital wallets, and over a dozen local payment methods with a fast, secure checkout that boosts conversions and builds customer trust. |
| 16 | |
| 17 | * Quick and frictionless checkout experience |
| 18 | * Customisable checkout pages |
| 19 | * Support for the most popular global payment methods (Visa, MasterCard, Google Pay, Apple Pay, American Express, PayPal, Klarna, etc.) |
| 20 | * 15+ local payment methods supported (iDEAL, Carte Bancaire, Bizum, Bancontact, etc.) |
| 21 | * Authorisation and Direct Sale modes for transactions |
| 22 | * Cancellations, captures and refunds management |
| 23 | * Seamless exemption management |
| 24 | * PSD2 and PCI-DSS compliant |
| 25 | * Localised payment experience in 100+ countries |
| 26 | * Multistore support |
| 27 | * No-code setup |
| 28 | |
| 29 | == Optimise your payment pages and boost conversion rates by up to 35% == |
| 30 | |
| 31 | Customise the design of your checkout page and give shoppers the payment options they know and trust. Activate popular local payment methods and create a more familiar checkout experience for international customers. A personalised checkout experience reduces cart abandonment rates and maximises conversion rates in every market you sell in. |
| 32 | |
| 33 | == Features == |
| 34 | |
| 35 | = Faster checkout = |
| 36 | |
| 37 | Use Worldline’s plugin to easily implement a checkout page on your store while avoiding the most common checkout errors. Let your customers either pay directly on your store with an embedded checkout page ([Hosted Tokenization Page](https://docs.direct.worldline-solutions.com/en/integration/basic-integration-methods/hosted-tokenization-page)) or get redirected to a secure Worldline page ([Hosted Checkout Page](https://docs.direct.worldline-solutions.com/en/integration/basic-integration-methods/hosted-checkout-page)) while keeping your shop PCI-compliant. |
| 38 | |
| 39 | = Customisable checkout pages = |
| 40 | |
| 41 | Make your checkout feel like a natural extension of your brand. This plugin offers customisable checkout templates, allowing you to match your store’s design, colours, and tone. |
| 42 | |
| 43 | Whether you want a minimalist payment form or a fully branded checkout, the plugin gives you flexible options to reinforce trust and keep shoppers engaged. |
| 44 | |
| 45 | = Global payments = |
| 46 | |
| 47 | Let your customers pay how they want — with credit card, digital wallet, bank transfer, mealvouchers, and more. Worldline’s WooCommerce plugin supports over 25 global and local payment methods across more than 100 countries and 150 currencies. |
| 48 | |
| 49 | You can enable or disable methods individually, set your preferred payment gateway titles, and fine-tune the checkout button text — all from your WooCommerce dashboard. |
| 50 | |
| 51 | = Multistore support = |
| 52 | |
| 53 | Selling across multiple stores or regions? This plugin is fully compatible with WooCommerce multistore setups, including multisite installations. |
| 54 | |
| 55 | Each store in your network can have its own independent payment configuration, including API keys, payment methods, currencies, and checkout behaviours. This gives you complete control when managing localised stores, marketplace-style setups, or international storefronts. |
| 56 | |
| 57 | == Supported Payment Methods and Currencies == |
| 58 | |
| 59 | Worldline’s GoPay plugin supports over 25 global and local payment methods, including: |
| 60 | |
| 61 | * Credit and debit cards (Mastercard, Visa, American Express, Cartes Bancaires, etc.) |
| 62 | * Bank transfers |
| 63 | * Digital wallets (Apple Pay, Google Pay, PayPal, etc.) |
| 64 | * Buy now, pay later providers (e.g., Klarna) |
| 65 | * Local payment methods (EPS, iDEAL, Bancontact, P24, Twint, etc.) |
| 66 | * Mealvouchers |
| 67 | |
| 68 | You can accept payments in 150+ currencies and serve customers in 100+ countries, ensuring a localised and conversion-friendly experience for every buyer — no matter where they are. |
| 69 | |
| 70 | = Add Worldline payments to your WooCommerce store today = |
| 71 | |
| 72 | Choose the secure, reliable, and future-ready payments solution designed to support your store at every stage of growth. Install the Worldline GoPay WooCommerce plugin in just a few clicks and start accepting payments across 100+ countries immediately. |
| 73 | |
| 74 | = About Worldline = |
| 75 | |
| 76 | Worldline is a leading global payments company with a unique mission: to turn payments from a simple necessity into a strategic advantage. As Europe’s leading payment service provider and ranked among the top worldwide, we power secure, frictionless online payment experiences. |
| 77 | |
| 78 | We combine scale (over 18,000 professionals operating in 40+ countries), cutting-edge payment technology and deep industry expertise to support more than 1.4 million businesses across 170+ markets. Whether you are a small shop or a large marketplace, our solutions are designed to fit your needs — helping you grow quickly, simply, and securely. |
| 79 | |
| 80 | == Screenshots == |
| 81 | |
| 82 | 1. Everything you need to accept online payments in just a few clicks |
| 83 | 2. See all of your transactions in WooCommerce orders dashboard |
| 84 | 3. Secure configuration for API keys, webhooks, and environments |
| 85 | 4. Pay using various payment methods |
| 86 | 5. Speed up purchases with single payment methods |
| 87 | 6. Monitor real-time transaction and account statistics |
| 88 | 7. Manage, track, and refund your transactions with ease |
| 89 | |
| 90 | == Installation == |
| 91 | |
| 92 | = Requirements = |
| 93 | |
| 94 | To install and configure the Worldline GoPay for WooCommerce plugin, you’ll need: |
| 95 | |
| 96 | * WordPress Version 6.3 (or newer) installed. |
| 97 | * An active WooCommerce store version 8.7 (or newer). |
| 98 | * PHP version 7.4 or newer. |
| 99 | * Worldline Merchant Account |
| 100 | |
| 101 | = Installation steps = |
| 102 | |
| 103 | 1. Log in to your WordPress Admin panel. |
| 104 | 2. Navigate to Plugins > Add New. |
| 105 | 3. Search for the “Worldline GoPay for WooCommerce” plugin. |
| 106 | 4. Click on Install Now and wait until the installation finishes. |
| 107 | 5. Click the Activate button on the success page (or activate it later in Plugins > Installed Plugins). |
| 108 | |
| 109 | = Configuration = |
| 110 | |
| 111 | **Connection** |
| 112 | |
| 113 | 1. After activating the Worldline GoPay for WooCommerce plugin, navigate to WooCommerce > Settings > Payments. |
| 114 | 2. Click “Manage” on Worldline GoPay for WooCommerce. |
| 115 | 3. Fill in the PSPID, API Key, and API Secret fields (live/test depending on your environment) from your Worldline Merchant Portal (Developer > Payment API). |
| 116 | 4. Click on “Save changes” to store these settings in the plugin. |
| 117 | |
| 118 | **Webhooks** |
| 119 | |
| 120 | 1. Navigate to Developer > Webhooks inside Worldline Merchant Portal and click “Generate webhook keys”. |
| 121 | 2. Copy the generated details into the fields “Webhook ID” and “Secret webhook key” inside the plugin. |
| 122 | 3. Choose if you’ll use manual or automatic webhook URL configuration under “Webhook URL Configuration”. |
| 123 | * Automatic (Recommended): The URL(s) listed below will be used for transactions from this store, and any webhook URL(s) configured in the merchant portal will be ignored. You can add up to 4 additional webhook URLs in “Additional Webhook URLs”. |
| 124 | * Manual: Copy the “Store Webhook URL” from the plugin configuration and add the webhook endpoint in the Worldline back office at Developer > Webhooks by clicking “Add Webhook Endpoint”. |
| 125 | 4. Click on “Save changes” to store these settings in the plugin. |
| 126 | |
| 127 | For more information on configuring the Worldline GoPay for WooCommerce plugin, check out our [official onboarding guide](https://docs.direct.worldline-solutions.com/en/integration/how-to-integrate/plugins/woocommerce). |
| 128 | |
| 129 | = Updating = |
| 130 | |
| 131 | The Worldline GoPay for WooCommerce plugin can be updated both manually and automatically. However, we still recommend backing up your site regularly, just in case. |
| 132 | |
| 133 | If you encounter any issues with the plugin or its functions after an update, purge your website cache. |
| 134 | |
| 135 | If that doesn’t solve the problem, create a thread on the [support forums](https://wordpress.org/support/plugin/worldline-for-woocommerce/) or contact our support team through [this form](https://docs.direct.worldline-solutions.com/en/about/contact/). |
| 136 | |
| 137 | == Changelog == |
| 138 | |
| 139 | = 2.5.22 - 2026-06-05 = |
| 140 | * Added: Timeout settings for hosted checkout |
| 141 | * Fixed: Load hosted tokenization only on checkout, harden API failure handling |
| 142 | |
| 143 | = 2.5.20 - 2026-05-28 = |
| 144 | * Fixed: Support new PAYID format |
| 145 | * Changed: Order details display for split payments |
| 146 | |
| 147 | = 2.5.19 - 2026-05-27 = |
| 148 | * Fix transaction error when coupon is applied |
| 149 | |
| 150 | = 2.5.18 - 2026-05-15 = |
| 151 | * Customize title of the payment methods for Single Payment Buttons |
| 152 | |
| 153 | = 2.5.17 - 2026-04-27 = |
| 154 | * Added: Configuration option to skip the Worldline payment confirmation page |
| 155 | * Fixed: PostFinance, TWINT and Bank Transfer translation labels |
| 156 | * Fixed: Compatibility with new SDK version |
| 157 | |
| 158 | = 2.5.16 - 2026-04-08 = |
| 159 | * Fixed: Add exception handling for when the API is unavailable |
| 160 | |
| 161 | = 2.5.15 - 2026-04-07 = |
| 162 | * Fixed: Renaming actions to prevent the WlopHtConfig object from being overwritten |
| 163 | * Added: Add SECURITY.md file |
| 164 | |
| 165 | = 2.5.14 - 2026-03-30 = |
| 166 | * Added: Support of Illicado payment method |
| 167 | * Added: Support of Wero payment method |
| 168 | * Fixed: Cancel webhook cancelling orders with a different transaction ID |
| 169 | * Fixed: Remove handling of canceled payment from the refund flow |
| 170 | |
| 171 | = 2.5.13 - 2026-03-17 = |
| 172 | * Added: Possibility to cancel partially or fully authorized transactions |
| 173 | * Added: Possibility to capture partially authorized transactions |
| 174 | |
| 175 | = 2.5.12 - 2026-03-09 = |
| 176 | * Added: Support of payment method “Blik” |
| 177 | * Added: Support of payment method “Przelewy24” |
| 178 | * Added: Support of payment method “Linxo Connect” |
| 179 | |
| 180 | = 2.5.11 - 2026-03-03 = |
| 181 | * Improved: Offer the possibility to only accept instant bank transfer on CAWL Gateway. |
| 182 | |
| 183 | = 2.5.10 - 2026-02-27 = |
| 184 | * Added: Deleting a consumer’s stored token from their account now also deletes the token on the payment platform |
| 185 | |
| 186 | = 2.5.9 - 2026-02-24 = |
| 187 | * Updated: Branding of Pledg changed to Sofinco |
| 188 | * Updated: Branding of iDeal changed to iDEAL | Wero |
| 189 | |
| 190 | = 2.5.8 - 2026-02-24 = |
| 191 | * Improved: Offer the possibility to only accept instant bank transfer. |
| 192 | * Fixed: Branding for Worldline Bank Transfer solution |
| 193 | |
| 194 | = 2.5.7 - 2026-02-10 = |
| 195 | * Added: Support of payment method “SEPA Direct Debit” |
| 196 | |
| 197 | = 2.5.6 - 2026-02-04 = |
| 198 | * Fix: Stability for 3DS exemption capabilities |
| 199 | |
| 200 | = 2.5.5 - 2026-01-28 = |
| 201 | * Fixed issue with displaying order on legacy Order data storage |
| 202 | * Improved exemptions capabilities related to 3DS exemption types |
| 203 | |
| 204 | = 2.5.4 - 2026-01-13 = |
| 205 | * Improved: Add subbrand for Apple Pay and Google Pay payment details |
| 206 | * Fix: Translation of card brands in the back-end |
| 207 | |
| 208 | = 2.5.3 - 2026-01-09 = |
| 209 | * Added: Additional information about transactions in orders overview and order details. |
| 210 | * Improved: Apple Pay is now supported with all browsers and devices |
| 211 | |
| 212 | = 2.5.2 - 2026-01-05 = |
| 213 | * Added: Possibility to auto-include primary webhooks URL in the payload of payment request, and to configure up to 4 additional endpoints. |
| 214 | * Added: Possibility to configure which logos will be displayed next to the “Credit cards” checkout option. |
| 215 | * Added: Orders that contain virtual and downloadable products will immediately go in a Completed status once the payment has been completed. |
| 216 | * Remove the Checkout Type field |
| 217 | |
| 218 | = 2.5.1 - 2025-12-09 = |
| 219 | * Add new payment method: Pledg |
| 220 | * Manage exemption for FR markets |
| 221 | |
| 222 | = 2.4.6 - 2025-11-17 = |
| 223 | * Fix language used for hosted checkout |
| 224 | |
| 225 | = 2.4.5 - 2025-10-29 = |
| 226 | * Change surcharge settings title |
| 227 | * Add pending order cancellation cron job logic |
| 228 | * Add upload logo for hosted payment to plugin settings page |
| 229 | * Change author URI and contributor |
| 230 | |
| 231 | = 2.4.4 - 2025-10-13 = |
| 232 | * Add missing 3DS parameters for Credit Card payments |
| 233 | * Fix storing the wrong API key in the database |
| 234 | |
| 235 | = 2.4.3 - 2025-09-23 = |
| 236 | * Fix Apple pay issue |
| 237 | |
| 238 | = 2.4.2 - 2025-09-19 = |
| 239 | * Fix plugin configuration page |
| 240 | * Fix translation issue |
| 241 | * Change plugin title to Offre e-commerce de CAWL |
| 242 | |
| 243 | = 2.4.1 - 2025-09-17 = |
| 244 | * Fix fatal error issue |
| 245 | |
| 246 | = 2.4.0 - 2025-08-11 = |
| 247 | * Add PayPal payment method |
| 248 | |
| 249 | = 2.3.0 - 2025-07-29 = |
| 250 | * Add Mealvouchers payment method |
| 251 | * Add CVCO payment method |
| 252 | * Add EPS payment method |
| 253 | |
| 254 | = 2.2.0 - 2025-04-29 = |
| 255 | * Allow SCA exemptions with Transaction Risk Analysis. |
| 256 | * Show totals with Surcharge on the checkout page. |
| 257 | * Add payment method logos on checkout. |
| 258 | * Improve settings tooltips. |
| 259 | |
| 260 | = 2.1.0 - 2025-03-31 = |
| 261 | * Added single payment methods (Klarna, PostFinance, Twint). |
| 262 | * Allow to capture payments automatically after the specified time. |
| 263 | * Improve UI in WooCommerce 9.6+. |
| 264 | * Show saved cards on the Pay for Order page. |
| 265 | * Handle saved cards in Hosted Tokenization. |
| 266 | * Add payment method icons in checkout. |
| 267 | * Fix handling of orders that had multiple payment attempts. |
| 268 | * Enable 3DS by default. |
| 269 | |
| 270 | = 2.0.0 - 2025-03-10 = |
| 271 | * Added Hosted Tokenization (credit cards) payment method. |
| 272 | * Added single payment methods (ApplePay, BankTransfer, GooglePay, iDeal). |
| 273 | * 3DS improvements (Frictionless Flow, Exempt Flow & Challenge Flow). |
| 274 | * Allow to specify templates of hosted tokenization and hosted checkout pages. |
| 275 | * Allow to change the payment method title. |
| 276 | * Allow to disable submission of the cart data. |
| 277 | |
| 278 | = 1.0.1 - 2024-10-02 = |
| 279 | * Allow to set test and live webhook credentials separately. |
| 280 | * Improve refunding, mark refunded items. |
| 281 | * Fix payment method title. |
| 282 | |
| 283 | = 1.0.0 - 2024-08-01 = |
| 284 | * Initial release. |
| 285 | |
| 286 | == Frequently Asked Questions == |
| 287 | |
| 288 | = How do I start using Worldline GoPay with WooCommerce? = |
| 289 | |
| 290 | To start using the Worldline GoPay for WooCommerce plugin, you need to: |
| 291 | |
| 292 | 1. Install the plugin. |
| 293 | 2. [Create a Worldline Merchant Account.](https://docs.direct.worldline-solutions.com/en/getting-started/) |
| 294 | 3. Enter your API credentials into the plugin settings. |
| 295 | 4. Enable your desired payment methods. |
| 296 | |
| 297 | You are then ready to start processing payments on your WooCommerce store! |
| 298 | |
| 299 | For a more detailed guide on configuring your WooCommerce plugin, please [refer to our official documentation.](https://docs.direct.worldline-solutions.com/en/integration/api-developer-guide/authentication) |
| 300 | |
| 301 | = How do I set up the Worldline GoPay for WooCommerce plugin = |
| 302 | |
| 303 | You can follow the steps outlined in the “Installation” tab on this page to install the plugin on your WooCommerce shop. Alternatively, you can find a more detailed installation guide on our [documentation website](https://docs.direct.worldline-solutions.com/en/integration/how-to-integrate/plugins/woocommerce). |
| 304 | |
| 305 | = Do I need a Worldline merchant account to use this plugin? = |
| 306 | |
| 307 | Yes, you need to create a Worldline Merchant Account to use this plugin. However, you can first [request a free test account](https://signup.direct.preprod.worldline-solutions.com/) to explore the plugin’s features before committing to it. |
| 308 | |
| 309 | = What are the requirements to use the plugin? = |
| 310 | |
| 311 | To use the Worldline GoPay for WooCommerce plugin, you need to meet the following requirements: |
| 312 | |
| 313 | * You need to have an active WooCommerce store version 8.7. or newer. |
| 314 | * You need to update your WordPress to version 6.3. or newer. |
| 315 | * You need PHP version 7.4 or newer. |
| 316 | * You need to have an active Worldline Merchant Account to process live payments. |
| 317 | |
| 318 | = Do I need to be PCI-DSS certified to use this plugin? = |
| 319 | |
| 320 | Yes, but you only need the lowest PCI-DSS certification (SAQ-A) when using Worldline GoPay for WooCommerce plugin. Its design ensures that all sensitive data is handled by Worldline directly. |
| 321 | |
| 322 | You can get the required SAQ-A certification level by filling in a Self-Assessment Questionnaire you can [find and download on our official documentation portal](https://docs.direct.worldline-solutions.com/en/security-and-risk-management/security/pci-dss). |
| 323 | |
| 324 | = How can I test the Worldline GoPay for WooCommerce plugin? = |
| 325 | |
| 326 | You can use a [Worldline test account](https://signup.direct.preprod.worldline-solutions.com/) to simulate payments before connecting a live Merchant Account. When you log into your test account, you can complete payments using test cards without affecting live data. |
| 327 | |
| 328 | = What type of logging or debugging tools are available? = |
| 329 | |
| 330 | The Worldline GoPay for WooCommerce plugin stores log data of API calls, webhooks, and transaction events for up to 30 days for debugging purposes. You can use this log data to communicate with our support team more efficiently and with fewer back-and-forth emails should any issue arise. |
| 331 | |
| 332 | Our support team is at your disposal for anything from interpreting your log data to providing assistance with debugging. Get in touch with any questions or issues through [this form](https://docs.direct.worldline-solutions.com/en/about/contact/). |
| 333 | |
| 334 | = Does the plugin support WooCommerce Subscriptions? = |
| 335 | |
| 336 | Unfortunately, no. The plugin doesn’t currently support WooCommerce subscriptions. |
| 337 | |
| 338 | = How can I contact Worldline GoPay for WooCommerce plugin support? = |
| 339 | |
| 340 | If you need help setting up the plugin, we recommend reviewing our [official plugin documentation](https://docs.direct.worldline-solutions.com/en/integration/how-to-integrate/plugins/woocommerce). In case you need additional support, please create a new thread on the support forums or contact our support team through [this form](https://docs.direct.worldline-solutions.com/en/about/contact/). |
| 341 | |
| 342 |