[[Changelogs|« Back to Changelogs]]

=Version 5.0.8=
*Release Type: '''MAINTENANCE RELEASE'''
*Release Date: '''26th July 2013''

==Bug Fixes==

Case 2949: Bad function name "db_escaoe_string"
 Case 2950 - Invalid token on Mass Mailer steps
 Case 2951 - Fix for PayPal callback returning HTTP 406 error on no amount
 Case 2953 - Duplicate admin log entries upon login
 Case 2955 - Invalid Entity Requested for Support Page/Module
 Case 2960 - Improve installer logic
 Case 2963 - Additional Domain Fields not saving input
 Case 2965 - Correct SQL statement for Ticket Escalations Cron routine
 Case 2967 - Domain registrar module command not running via order accept routine
 Case 2974 - Fix for invoices with a zero total not being auto set to paid on generation
 Case 2975 - Fix for Calendar Entry Type Checkboxes not retaining selection
 Case 2977 - Calendar Entries Missing Addon Name for Predefined Addons

=Version 5.0.7=
*Release Type: '''SECURITY PATCH'''
*Release Date: '''23rd July 2013'''

===Security===
Case #2755 - Audit & Code refactor backport

=Version 5.0.6=
*Release Type: '''SECURITY PATCH'''
*Release Date: '''16th May 2013'''

===Security===
Case #2620 - Improved sanitization in client area

=Version 5.0.5=
*Release Type: '''SECURITY PATCH'''
*Release Date: '''23rd April 2013'''

===Security===

*Details to be released in due course
*Added CSRF Token Management User Configurable Settings to General Settings > Security

=Version 5.0.4=
*Release Type: '''SECURITY PATCH'''
*Release Date: '''12th March 2013'''

===Security===

*Details to be released in due course

=Version 5.0.3=
*Release Type: '''MAINTENANCE'''
*Release Date: '''14th December 2011'''

===Bug Fixes===

*Removed all hardcoded text variables from new client area templates and moved to language files
*Updated new client area template menu bar to auto hide add funds option when disabled, and display more billing related shortcuts in Billing dropdown menu
*Added homepage widget for staff noticeboard to allow bringing to attention new notices, and simplified admin permissions config for them
*Added homepage widget for providing an overview and quick access to support tickets
*Updated styling of the System Overview widget box
*Added Check All checkbox options to Clients, Products, Addons, Domains & Affiliates listings within the admin area to make sending bulk emails to all users matching a selected criteria easier
*Added Message Preview functionality to Custom Email and Mass Mail Sending Pages to preview merge fields output and formatting
*Renamed Network Issues Login setting to Service Status, and updated to apply to both network issues and server status pages
*Update to Slider template to display product categories on first visit
*Update to AutoAuth to support Contact Logins also
*New Modules for GameCP and EEECurrency
*Ticket close button showing even for closed tickets
*Added Delete Stored Credit Card option to new client area template
*Bulk domain management buttons not submitting in new default template domains listing page
*Registrar lock always showing as disabled and not enabling on click in new default template
*Server status port checks failing due to missing foreach key value from new default template
*Added automatic GeoIP Lookup shortcut to admin logins widget IP addresses
*Addons directory link missing from admin menus
*Admin Login & WHOIS Log pages failing to retrieve actual log data
*Client area sorting by status in both products and domains lists not working
*Knowledgebase search failing to find matches with articles assigned to multiple categories
*Admin support ticket notifications not always sending to all assigned admin users
*Update to order confirmation email notification to not include admin only custom fields
*Items being ordered in multiple quantities were not having discounts multipled up by quantity in cart
*Update to reCAPTCHA library to use SSL for file includes when being served over SSL
*Admin Support Department Ticket Reassignment Notification email not applying message formatting
*Fix for PDF Invoice not showing specified tax label when tax rule relates to a specific country
*PayPal Express module link error resolved for regular paypal payments from invoices
*Removed protected attribute from TCPDF SetPageFormat call to allow for use within template files
*Promotional discount not displaying correctly on invoices for new orders with prorata
*Fix for escaping of JS code in network issues widget causing admin homepage to stop loading in some environments
*Order Form Updates to resolve issues with comparison template summary, addons not displaying in Slider template, addons styling updates to all templates, fix for missing div tag in cart template & floating divs for products & addons in modern template becoming out of line
*Removed number of services link from the admin clients page listing
*Disabled error reporting in the server status monitoring file
*Fix for auto system URL input correction with custom admin folder names
*Printable Admin Ticket View not having line breaks and formatting applied for new tickets
*Addon Modules duplicating config values upon save
*Update to add support for captcha options from the system homepage domain checker, general updates to captcha input styling, fix for bulk domain checker not performing captcha validation, and updates to ajax based order forms to auto run domain transfer checks on pass thru
*Custom module functions not displaying the success/failure response messages when run
*Upgrades from free products being blocked on the admin side
*Heart Internet & Nominet Sync Scripts Updates
*Admin support sidebar not counting up tickets per department correctly under some conditions
*Product Bundles Admin Config not saving product/domain addon values correctly, or allow promo setting
*New Hook Points: AdminClientServicesTabFields/Save + Same for Domains, AfterRegistrarXXXFailed with XXX being Registration/Transfer/Renewal & TicketStatusChange

=Version 5.0.2=
*Release Type: '''STABLE'''
*Release Date: '''24th November 2011'''

=Version 5.0.1=
*Release Type: '''RELEASE CANDIDATE'''
*Release Date: '''14th November 2011'''

=Version 5.0.0=
*Release Type: '''BETA'''
*Release Date: '''7th October 2011'''

2013-06-28T15:55:14Z

Chris:

{{gateways
| onetime = yes
| recurring = yes
| refunds = yes
}}

==Recurring Billing==

As of WHMCS V4.5, it is possible to have automated recurring billing agreements created with 2CheckOut from WHMCS. This is done using the 2CheckOut API and so if you wish to use this functionality you will need to enter your API Username & Password in the module config (see below for details).

==Module Setup==

===Notifications===

To setup the callback process for 2CheckOut to automatically mark invoices paid, you will need to login to your 2CheckOut account and then go to the '''Notifications''' section of your account. There you should see a field for a '''Global URL'''. In that field, enter the url http://www.yourdomain.com/whmcs/modules/gateways/callback/tco.php and then click '''Apply'''. Also click the '''Enable All Notifications''' button and then save to complete.

===Direct Return===
In order to return clients back to your WHMCS installation after a successful payment you can configure Direct Return within the 2CO control panel. Navigate to '''Account > Site Management > Direct Return''', select the "Direct Return" option and set the URL to http://www.yourdomain.com/whmcs/modules/gateways/callback/2checkout.php

===Secret Word===

For added security, you can set a '''"Secret Word"''' inside your 2CheckOut account @ '''Account > Site Management'''. If set, this is then used to validate callbacks are authentic and it is therefore '''recommended''' that you do this. If you choose to enable it, then you must also enter the exact same word that you set inside the 2CheckOut control panel into the WHMCS Secret Word field in '''Setup > Payment Gateways'''

===API Username/Password===

If you wish to be able to use the '''recurring billing and/or automatic refunds functionality''' within WHMCS, then you must setup a 2CheckOut API user and enter the details in these fields.

To setup an API user, you will need to login to your 2CheckOut account and go to '''Account > User Management > Create Username'''. Once there you will be asked to enter an email address, username & password, security question & answer, and then select the permissions for the user. You just need to select '''API Access & API Updating''' for the permissions. Once you've done that you would then enter the same username & password that you just created into the appropriate fields inside WHMCS.

===Purchase Routine===
When unticked the standard '''spurchase''' routine will be used. Tick this option to use the more modern '''purchase''' checkout process which includes the option for clients to pay via PayPal.

==Error Messages==

===Demo Mode===

In order to use demo mode, the "Demo Setting" in your 2CheckOut account should be set to "Parameter" under '''Account > Site Management'''. Demo mode can then be enabled by ticking the checkbox in WHMCS under '''Setup > Payments > Payment Gateways'''.

Please note that when using demo mode, all callbacks from 2CheckOut will fail with the error MD5 Hash Failure if a secret word is specified. This is done intentionally by 2Checkout to protect those who sell digital goods from fraudulent purchases through their demo mode.

'''In Demo Mode, valid credit card data must be submitted in order to properly perform the request. Credit cards will not be charged during this process'''

===MD5 Hash Failure===

An MD5 Hash Failure error under '''Billing > Gateway Log''' indicates that the Secret Word in '''Setup > Payment Gateways''' does not match the Secret Word in the 2CheckOut control panel. Double check your entry is exactly right, and check for any invisible trailing spaces if so.

{{modules}}