Square 2.2.0 Changes (Released 10/28/20)

• Made Compatible for WHMCS 8x
• Backwards Compatible for WHMCS 7x
• Create Permissions for Sub-Users to access invoicing if allowed set by primary Account Owner
• Overhaul manage.php to work with Account Creation on SquareUp
• Fixed Add Credit Card API
• Fix Remove Credit Card where Cards were not removing from WHMCS
• Fix Gateway Code to use $params or $GatewayConfig parameters dependent on invoice rather than using Laravel due to encryption with WHMCS 8x
• Clean source Code
• Ensure Remote Capture and Refunds work with new code

More Information found on our Release Announcement Page.

https://mybeastportal.com/announcements/25/Square-2.2.0-Released-and-Compatible-with-WHMCS-8x.html

#Version 2.1.1 Changelog

• Fix error with adding and displaying saved Credit Cards due to API lookup issue
• Fix support for installations that choose not to do Currency Conversion

#Planned Update Roadmap

*Multiple Domain Support

#Version 2.1.0 Changelog

• Fix Currency Conversion issues by adding a convertCurrency function
• Fix manage.php and add_submit.php for card retrieval and add issues
• Move Charge Card on File form outside of square form as this was causing issues.

#Version 2.0.0 Changelog

• Fixed Bootstrap Charge Form for One-Off Payments
• Create hooks.php in includes folder of WHMCS. (If this is deleted, features of Square will be missing)
• Added Functions to View, Add and Remove Credit Card for Recurring Payments. Square does NOT allow Editing Credit Cards with the API.
• Used DeletePayMethod API in WHMCS to allow deletion of Cards so that Administrators don't need to remove for the customer
• Add function to WHMCS to store Gateway Token for grabbing data with API call upon Charge Request with Attempt Capture Button (Uses AddPayMethod Class)
• Add functioning Capture Function and Button
• Enable Capture Function to send an email if Card was Declined or Approve
• Added Code to properly log failure notices on Attempt Capture
• Ensure Cron Jobs work with Capture Attempts
• Add Link for Manage Square Credit Cards under Billing in the Client Area
• Add Action Hook for Manage Square CC Information in Client Area HomePage
• Add Action Hook using ClientAreaHeadOutput to change URI for the Add Credit Card Button in Billing > Manage Pay Methods to override the default Credit Card Form
• Implement Banners for phasing out earlier versions of PHP and WHMCS for later versions of Square
• Implement a fully functional trial, where ALL Addons work (done with Square 1.15)
• Implement a Developer Key where all functions will work, but banners will be used as this mode is strictly for testing
• Edit License.php to make Developer Mode fully functional, where Addons work
• Edit License.php to fix Update Banner to include a spot for notes and a link to the announcement or kb article containing notes about the newest release
• Add Banner letting know if an update was available for Square (Requires Active Support & Updates Package)
• Add Banners for a Sandbox mode
• Added Banner on Recurring page to warn Payments are Recurring as per Squares recommendation (Might be customizable in later versions)
• Added option to select a Card on File to Charge with one-off payment form
• process-ccof.php Works successfully with v2 Payments using Curl instead of API
• Fixed System Url on square.php to prevent double slash in public URI
• Eliminate process-card.php which used the Square API. ChargeCard.php uses cURL to allow for easier development and expansion
• Support for Refunds
• Cleaned up code

TO DO:

• Dispute Center in Admin > Modules> bws_square for Disputes (Addon License)
• Multiple Domain Support

Bug Fixes

• Fixed square bootstrap form to fix form values and javascript to allow processing. This was an oversight in 1.13.
• Added API directly to form as a failsafe for location pulling.
• Added API directly to process-card.php as it was not grabbing the location correctly through WHMCS.
• These corrections fixed the errors reported via support tickets.

Version 1.13 Changes

• Enhance Form Customization Option
• Enhance Branding Removal Option with HTML Editor for Branding
• Make Payment Form Bootstrap to support any WHMCS Theme
• Move Licensing Banners into License.php
• Allow Trial Licenses to be fully functional with Branding Removal and Form Customization
• Write New Install Instructions to Website
• Add WHMCS Version compare to prepare for WHMCS 8.0.0 as PHP 7.3 and greater will only be accep

#TO DO:

• Recurring Payments
• Recurring payments is in the works, and is currently being designed. This will allow the use of the Attempt Capture and will store Credit Card Data via Square and NOT WHMCS.
• Create New Licensing Tiers

Version 1.12 Changes

• Allow Customization of Payment Form
• Moved Branding Addon to Addons Section
• Added protocol in Licensing to check the server for new updates, and display a message

#TO DO:

• Support for Recurring Payments (Will create a save card while waiting on API) -- Top Importance
• Create New Licensing tiers.

Version 1.1.0 Changes

• Fix API to work with new API Key format, and URL's
• Fixed API URL's (Both sandbox and Operational)
• Fixed ApiClient and Configuration to host new URL's
• Cleaned Payment Gateway section to move Licensing to Addon (Current clients will need a license refresh)
• Fix Payment Form so that Sandbox and Operational correctly get card nonce
• Allow detection of correct currency that is set in WHMCS
• Ensure PCI compliance is working and ensure that form is tokenized. (Form does not save ANY card data to WHMCS Database)
• Clean up square.php to ensure payment processing works smoother.
• Allow ProcessCard and API pages to correctly use Capsule to get Sandbox and operational modes, along with current currency and payment amount.

#TO DO:

• Support for Recurring Payments (Will create a save card while waiting on API) -- Top Importance

Version 1.0.8 Changes

• Fix API Urls
• Ensure PCI Compliant
• Fix Card Nonce and Processing Issues

#TO DO:

• Support for Recurring Payments (Will create a save card while waiting on API) -- Top Importance
• Overhaul the API
• Move Licensing to a Module
• Allow WHMCS to use Attempt Capture (Depending on API)

Version 1.0.7 Changes

• Fix Licensing Server to new location
• Fix Currency to show correct Currency, and send new Currency to the gateway.

#TO DO:

• Support for Recurring Payments (Will create a save card while waiting on API)
• Overhaul the API
• Move Licensing to a Module
• Allow WHMCS to use Attempt Capture (Depending on API)

Version 1.0.6 Changes

• Remove the requirements for smarty php tags to be required by creating a single .tpl file which links into the php files to control the operations of square.
• Move License to a folder to control licensing
• Move License Key input into WHMCS Admin
• Remove the need for the $installDir tag, which is now automatically detected.
• Allow Custom Branding to be added (requires Branding Addon)
• Add Notification for new version if client has Support & Updates Package
• Add to Instructions Sandobx requires the use of Legacy Key in Developer Mode.

#TO DO:

• Support for Recurring Payments (Will create a save card while waiting on API)
• Overhaul the API

Version 1.0.5 Changes

• Addition of onclick event to disable submit button once pressed to prevent double charges
• Update instructions to note that currency code and country code can be changed as needed if conversion somehow fails in WHMCS.

Version 1.0.4 Changes

• Cleanup index.php and process-card.php
• Continued to test using unique id for idempotency issues discussed in Version 1.0.3 -- RESOLVED
• Repair process-card.php - Customers were receiving 500 errors after submitting CC details. Fixed PHP versioning issues/ directory file naming bugs.

Version 1.0.3 Changes

• Idempotency Key changed from string to unique id.

The idem key was not correctly changing the key each time, and was allowing transactions to fail. With this change, when you refresh the invoice the key will change, thus allowing the charge to go through correctly. The idem key does prevent duplicate charges! Those that download a 30 day trial, or have an Owned License and have a VALID Updates Subscription will be able to receive this update!

For those with a current license, make sure you do not replace license-key.php as it will override your license and you will need to re-add the license key. You also do not need to update square.tpl to your template directory.

Hotfixes to fix the following:

• License Validation Structure
• Directory Structure for WHMCS installs not in a root folder. You will be able to edit square.tpl to specify your folder name
• Hot Fix to allow below PHP 7. This will also work with lower versions of the IonCube Loader as well.

Hotfixes:

• process-card.php was giving a corrupt error with IonCube. After reviewing the code, comment styles have been fixed, and this version fixes the corrupt file issue. If you have any issues, please contact us, and we'll be glad to assist!

Initial Release