PHP 5.2 or later
MySQL 5.0 or later
Access to your FTP server or your MySQL database
At least Internet Explorer 9 or preferably the latest versions of Chrome/Firefox/Safari or other modern browsers.
At least v1.7 of Prestashop
This guide assumes that Prestashop v1.7+ has already been installed. If it has not been installed there is a guide on how to do it here: http://doc.p restashop.com/display/PS16/Installing+PrestaShop.
If you are using an older version of Prestashop you will have to add the old plugin and follow the instructions on this page.
1. At the moment, the Simplify plugin is not bundled with PrestaShop. For the most up-to-date version of the plugin, download the zip file from here.
2. A registered account on the PrestaShop addons marketplace is needed in order to download this.
3. Log in to the PrestaShop admin page, go to the Modules section and click 'UPLOAD A MODULE'.
4. The 'Upload a module' box should be shown on the screen. Drag the file you just downloaded on to the screen or press the 'select file' link and browse your computer's directory to find the zip you downloaded.
5. The pop up screen should change to this if the installation was successful:
6. You can now click the 'CONFIGURE' button on the above screenshot to set up the plugin. You can also go to Modules --> Installed Modules and click the configure button beside the Simplify Commerce plugin.
This should bring up the configuration page below:
7. The configuration page above contains the following:
API Key Mode - This is set as Test Mode by default, when ready to go Live, change it to Live Mode.
Set Your API keys - They can be found on the Simplify Commerce account that is going to be used (you might want to create a new key pair specifically for PrestaShop):
Live Public Key – This is the live key found on the API Keys section for live payments.
Live Private Key – This is the live key found on the API Keys section for live payments.
Test Public Key – (Test Mode) – Sandbox must be enabled to use this field.
Test Private Key – (Test Mode) – Sandbox must be enabled to use this field.
Save Customer Details - Allows the customer to save their details so the next time they want to purchase something they wont need the card details
- Payment Mode – Two options on how the card form should appear.
- Standard – The card field appears on the checkout page.
- Hosted Payments – Hosted Payments must be enabled in the simplify API Keys settings.
- With SSL: A modal dialog will appear on the checkout page.
- Without SSL: Customers are redirected to Simplify Commerce's secure site to pay.
Modal Color – Only available when Hosted Payments is selected above in Payment Mode.
8. Once all of these settings and API keys are configured, click the save button to commit the changes.
9. The plugin can be enabled and disabled by clicking on the drop down beside the configure button on the Modules page.
If Simplify Commerce is not appearing on the checkout page, it may be an issue with SSL. The grade of the SSL can be tested on https://www.ssllab s.com/ssltest/ by entering in the main website address. That page will report some of the issues with the SSL setup.
If there is an API error being received, it should be checked that the correct Public & Private Keys have been input (not test keys) and that Test Mode is disabled.
If there are difficulties arising with the version of PrestaShop running and need to reinstall, the guide can be found here: http://doc.prestas hop.com/display/PS16/Installing+PrestaShop.
Frequently Asked Questions
How do we know if the payment request comes from PrestaShop plugin?
The user agent string = "PrestaShop" from all HTTP calls coming from PrestaShop plugin
Where can I check for errors?
They can be accessed through the admin console "Advanced Parameters" --> "Logs"
Is there anywhere else I can see the logs?
If you have access to the PrestaShop database you can check the ps_log table (this is the table showing the information in the screenshot above) and have a look at the row entries around the time of the error (example below is using phpMyAdmin):
Is SSL needed to go live with PrestaShop?
SSL is needed unless you use hosted payments.
Is Simplify Commerce bundled with PrestaShop?
No, it no longer comes pre-bundled since PrestaShop 1.6 and above. You will have to install using the instructions above.