Please allow up to 24 hours before receiving the download link specified above. To install the plugin, please follow the instructions below.
Wooline Gateway Click Subscriptions Plugin Installation Guide
(Used for WooCommerce regular and subscription payments)
Supports automatic renewal payments with the WooCommerce Subscriptions extension.
- Supported features:
- Products
- Refunds
- Tokenization
- Change Payment Features
- Payment Method Change Customer
- Payment Method Change Admin
- Subscription features:
- subscriptions
- Multiple Subscriptions
- Cancellation
- Suspension
- Reactivation
- Amount change
- Date change
Plugin Installation Guide V 7.5 11/01/2024 - Author YHP LTD
*** Wooline Gateway Click Subscriptions Changelog ***
= V 1.0 =
This is our first fresh version for WooCommerce regular and subscription payments.
== Upgrade Notice ====================
Who are using WooCommerce subscriptions can use our this plugin for their regular and subscription payments.
= V 2.0 =
* Second version
* Version Date: 01 June 2021
1) Added a Cron function to check and update the payment status from Click Worldline (previously known as Paymark).
2) It runs every 5 minutes and fetches the last 24 hours records from the Click Worldline (previously known as Paymark) server and updates the order status of WooCommerce if an order has been paid on Worldline (previously known as Paymark) but status at WooCommerce level is not 'processing' or 'completed'.
3) Made the compatibility with the latest version of WP V 5.7.2 and WC V 5.3.0.
= V 3.0 =
* Third version
* Version Date: 09 July 2021
1) Added a new feature to edit subscription.
2) Admin can add/edit the subscription items.
3) Subscription total amount change is allowed now.
= V 4.0 =
* Fourth version
* Version Date: 05 Oct 2021
1) Added new WooCommerce Hoocks to manage subscription renewal payments.
2) Fixed some bugs.
3) Made the compatibility with the latest version of WP V 5.8.1 and WC V 5.8.0.
= V 5.0 =
* Fifth version
* Version Date: 15 Nov 2021
1) Upgraded the brandigs from paymark to worldline.
2) Made the compatibility with the latest version of WP V 5.8.2 and WC V 5.9.0.
= V 6.0 =
* Sixth version
* Version Date: 06 Aug 2022
1) Added the new feature to tokenize the Credit Card as a new payment method.
2) Provided the selection feature of Credit Card on checkout if already added.
3) If an already added Credit Card is used the page will not redirect to Worldline (previously known as Paymark) gateway and the transaction will be done in the background via the saved token of that Credit Card.
4) If any subscription transaction failed an email is sent out to the user and he can renew it from my account, for further transactions that new Credit Card will be used without cancelling the subscription.
5) Showed the used card type and last 4 digits on orders so user know the used card for that order.
6) Added Multiple Subscriptions feature
7) Made the compatibility with the latest version of WP V 6.0.1 and WC V 6.7.0.
= V 7.0 =
* Seventh version
* Version Date: 31 Oct 2022
1) Added the new feature to Change payment method in already running subscriptions through Worldline (previously known as Paymark) by using a new card
2) Added additional feature for already running subscriptions through Worldline (previously known as Paymark) one can add new Card by selecting the arleady added card on Worldline (previously known as Paymark).
3) Added checkbox if any user want to change the new card for his all running subscriptions in one go.
4) Made the compatibility with the latest version of WP V 6.0.3 and WC V 7.0.0
= V 7.1 =
* Version Date: 4 Nov 2022
1) Fixed with async upgrade as per latest WordPress core updates V 6.1.
2) Made the compatibility with the latest version of WP V 6.1 and WC V 7.0.0.
= V 7.2 =
* Version Date: 14 Dec 2022
1) Added option to update all subscriptions at once by adding new CC as payment method.
2) Made the compatibility with the latest version of WP V 6.1.1 and WC V 7.2.2.
= V 7.4 =
Release Date: November 22, 2023
In version 7.4 of our plugin, we have introduced significant improvements and updates. Please take note of the following changes:
1) Enhanced support for the new high-performance order storage feature in WooCommerce.
2) Rebranded from YHP Worldline to Wooline.
3) Ensured compatibility with the most recent versions of WordPress (v6.4.1) and WooCommerce (v8.3.1).
We recommend updating to this version to benefit from these enhancements and ensure seamless operation. Thank you for choosing our plugin!
== Upgrade Notification for V7.4: ====================
Crucial Note: Users must manually transfer previous subscriptions as they will not automatically migrate to this version.
NOTE: Before utilizing this new plugin, kindly uninstall our standard plugin (YHP Worldline Gateway Click / Wooline Gateway Click).
Important: Ensure complete removal of our previous plugin (yhp-worldline- subscriptions-gateway-click) before installing this version.
This update is optional and is intended for those who wish to utilize the new high- performance order storage feature in WooCommerce.
To access this feature, navigate to WooCommerce -> Settings -> Advanced -> Features tab, provided that you are using WC version 7.1 or higher.
For users with WooCommerce versions above 7.0, we recommend installing this new version 7.4 as a fresh copy, as we have rebranded from YHP Worldline to Wooline.
PS: Upon activating the plugin we've created, a new feature is in place that will automatically transfer all settings from your previous version. You simply need to review and save the settings once within the plugin's configuration.
WooCommerce High performance order storage new feature screenshot:
= V 7.5 =
Release Date: January 11, 2024
In the latest iteration, version 7.5 of our plugin introduces notable enhancements and updates. Kindly take note of the following modifications:
1) Enhanced the efficiency and ensured compliance with regulations in the Credential on File (CoF) transaction processing system.
2) Verified compatibility with the latest versions of WordPress (v6.4.2) and WooCommerce (v8.4.0).
We recommend updating to this version to benefit from these enhancements and ensure seamless operation. Thank you for choosing our plugin!
== Upgrade Notification for V 7.5: ====================
NOTE: Before utilizing this new plugin, kindly uninstall our standard plugin (YHP Worldline Gateway Click / Wooline Gateway Click).
Important: Ensure complete removal of our previous plugin (yhp-worldline- subscriptions-gateway-click) before installing this version.
We strongly advise updating to this version to leverage these improvements and guarantee a smooth operation.
Before you begin, please consider the following points:
1. Deactivate or delete the older version of the click plugin (Wooline Gateway Click/ YHP Worldline Gateway Click / YHP Paymark Click Gateway / WooCommerce Click Gateway) before using this plugin.
2. If you are currently using our subscription plugin (yhp-worldline-subscriptions-gateway-click) please remove it completely and install a fresh copy of this plugin, after installing this plugin, you must set up all your active subscriptions again with this plugin.
[ If you wish to retain all your old subscriptions, it can be technically achieved by making direct changes in the database. However, the process of making these changes and switching will incur a fee based on the number of old subscriptions. ]
NOTE: Begin by creating an Online Click account with Worldline (previously known as Paymark) and installing WooCommerce Version > 7.0 along with the WooCommerce Subscriptions module for handling subscription payments.
Obtain the plugin by downloading it from https://www.wooline.co.nz/wooline-worldline-click-subscription/
Upload the plugin files to /wp-content/plugins/ using FTP or through the WordPress admin screen. Go to Plugins > Add New.
Extract or install the uploaded file.
Access your WordPress admin portal by logging in at the following URL, replacing "yourdomain.nz" with your actual domain: https://yourdomain..co.nz/wp-admin/ .
Navigate to the "Plugins" section.
Look for the plugin titled "Wooline Click Gateway Subscriptions" within the list of available plugins
Click on the "Activate" link to enable the plugin. Once activated, you'll have access to the plugin's settings options as shown below:
To access the plugin settings, you can go to "Settings" via WooCommerce by following the path "WooCommerce -> Settings -> Payments." You can also reach the settings by clicking on "Manage" as indicated in the screenshot below.
Configure settings as required:
Note: You must set the store currency to NZD to use this plugin.
Error message when currency is not set to NZD
Please input the Client ID, Account ID, and API Password based on the details provided in your merchant activation email from Click Worldline (formerly known as Paymark). You can generate the API password by following the instructions in the merchant email or by logging into your Worldline (previously known as Paymark) Click account.
Important Note: Adjust the test mode settings according to your account. If your account is in demo mode, enable the test mode. This allows you to test your integration without involving actual funds. All transactions will be processed through the Click Payment simulator.
To facilitate testing, you can create a demo/sandbox account on the Worldline (formerly known as Paymark) website and utilize the test credentials sent to your registered email. Ensure that you have enabled the test mode to utilize these credentials.
Demo screenshot of checkout with subscription product:
Demo screen shot of subscription order received after payment :
Demo screen shot of subscription order details in admin:
An order has been successfully placed using a new card. The card used has been automatically added and is accessible for viewing in the "My Account -> Payment Methods" section.
Click on "Add Card," and you will be redirected to the Click Worldline gateway. Enter your credit card details, and upon submission, you will return to the same page with the newly added credit card appearing in the list above.
Make sure to check the "Update the Payment Method used for all of my active subscriptions" checkbox to apply the new credit card to all your current active subscriptions.
Users have the option to designate any of their cards as the default card, and this selection will be automatically applied to their next checkout page.
Next Check out page demo screenshot: If a card is already saved, the user will not be redirected to the Worldline/Paymark gateway. Instead, the payment will be processed using the saved card token, streamlining the checkout process for added convenience.
To modify the payment method for any active subscription, utilize the "Change Payment" option from its detailed page.
On the following screen, you'll encounter options to either use a new card or select an existing card. Ensure that any previously added card has been added through Worldline if you choose the existing card option.
Check the box labeled "Update the payment method used for all of my current subscriptions (optional)" if you wish to change the payment method for all your ongoing subscriptions from Worldline simultaneously.
If you choose an existing card (one that has already been added), upon submission, the payment method will be saved for future transactions.
If you opt for a new card selection, follow the on-screen instructions after submission to complete the process.
To manually renew any subscription, navigate to its detailed page and click on the 'Renew Now' button. Follow the on-screen instructions to complete the renewal process.
The manual renewal process can also be applied to subscriptions with failed transactions. Follow the same process mentioned earlier by going to the subscription's detailed page and clicking on the 'Renew Now' button, then follow the on-screen instructions.
In the event of a failed auto-renewal transaction, the plugin automatically sends an email to users. The contents of the email are as follows:
Users have the option to either copy and paste the URL provided in the email or directly click on it. This will lead them to the details of the failed order, allowing them to take the necessary actions to address the issue. In the case of failed cards, users are required to change the payment method by selecting a new card. This action updates the card information for upcoming subscription orders.
For any assistance, feel free to contact us at 0800 932337 or email us at help@wooline.co.nz. You can also visit our website at https://www.wooline.co.nz. We're here to help!
