Plugin Installation & Configuration
Follow these steps to install the plugin!
Download Magic Plugin
Start by downloading the latest version of our Prestashop 1.6 plugin
Important!
Once you have installed and configured the plugin, be sure to:
- Test all its functionalities including order checkout flow and refund flow
- Appearance of Magic Checkout on product, mini-cart and cart pages.
- Correctly insert the API key to go live.
Install your Prestashop Plugin
- Login at your admin panel with your credentials.
- After successfully login to backend admin, select from left navigation Module --> Module Manager
-
On the module list page click on Upload a Module
-
Click on Browse button and upload your Magic.zip file
-
When you click on Install now button plugin will be uploaded and installed then you will be redirected to Magic configuration page.
-
After installation, you will be redirected to Magic configuration page*. You will need to enable Magic** module and save configuration using the save button at the bottom of the page
Plugin Configuration
Our Magic Checkout plugin is thought and developed to be ready out-of-the-box. If you have any problems or issue configurating your plugin, please contact our support at [email protected]
To configure the plugin, go to Modules --> Module Manager on the left menu, find Magic Checkout and click on “Configure” and follow the steps below.
- By default, Magic is disabled. Remember to select Enabled to Enable the plugin and fill correctly the fields Mode, Merchant Token and Merchant Secret Key.
To make sure you have installed the plugin with the Staging configurations correctly set, you have to find all this value in the configuration panel:
Staging Environment
Mode
StagingToken
ea4db480-8a63-4b89-9a09-7e46f3092810Secret Key
e684a129-36a0-46d3-8176-801f797f06ab
Remember to click on the Save button at the bottom of the box.
Advanced Configurations
Magic Checkout plugin has even a check that cancels orders and restock item quantity if orders remain with status "Awaiting payment" on Prestashop and in status "refunded_not_charged" on Magic back-end for more than one hour.
To use that function, you have to set the following cron job: /5 * * * wget --quiet -O /dev/null http://www.paymeo.com.au/prestashop-magic-staging/module/magiccheckout/cron
After that, you have to setup a cron job even on server side (on *nix systems using crontab command) appending the following command to your existing crontab:
*/5 * * * * wget --quiet -O /dev/null http://www.paymeo.com.au/prestashop-magic-staging/module/magiccheckout/cron
Enable Magic Checkout - Product Page, Cart Page and Mini-Cart
Now, with the updated version of the plugin, you can add Magic Checkout button in 3 different areas of your site:
1- Product Page
2- Cart Page
3- Mini Cart
In the table below you will find the mapping of all the attributes you can find in the Magic Checkout Configuration panel on the Back-Office.
Enable/Disable | Status of the Magic Checkout Plugin |
---|---|
Mode | Select your environment Mode: Staging/Production |
Merchant Token | Provided in your merchant onboarding email |
Merchant Secret Key | Provided in your merchant onboarding email |
Enable/disable Magic Checkout on Product Page | Enable the toggle to show Magic Checkout button on Product Page or disable it to hide the Call to Action |
Product Page - selector (for rendering Magic button) | HTML element selector where to show Magic Checkout below |
Enable/disable Magic Checkout on Cart Page | Enable the toggle to show Magic Checkout button on Cart Page or disable it to hide the Call to Action |
Cart page selector (for rendering Magic button) | HTML element selector where to show Magic Checkout below |
Enable/disable Magic Checkout on Mini Cart Page | Enable the toggle to show Magic Checkout button on Mini Cart Page or disable it to hide the Call to Action. (note This switch will be disabled if there are any disabled categories selected in the properly configuration field described below) |
Mini Cart page selector (for rendering Magic button) | HTML element selector where to show Magic Checkout below |
Show Fiscal Code | The plugin saves the DNI/Fiscal Code/Codice Fiscale on the Invoice Address of the order. This configuration maintain the compatibility with previously versions of this plugin. If you have already update the Address Format on International->locations->country you can disable it. |
Order Awaiting Status | Indicate the Order Waiting Status before the customer finalizes payment. |
Order Status | Indicate the Final Order Status after the customer finalizes payment. |
Enable Magic Checkout in Specific Countries | Magic Checkout will be shown only in the selected countries. |
Disable Specific Shipping Methods on Magic Checkout | Select Shipping Methods not allowed inside Magic Checkout |
Enable Magic Checkout in Specific Currencies | Magic Checkout will be shown only in the selected currencies. |
Disable Magic checkout in specific Categories | Magic Checkout will be shown in every categories except in those selected. (note If there are selected categories the Mini-cart will be always disabled) |
Analytics Scripts | All the Scripts used to track the Order flow |
Button Style | Add some style to the button. This style will be added to wrapper div of the button. |
Enable Error Logs | Status of the collectable Magic Checkout Error Logs |
NB - ADVANCED CONFIGURATION
You can find 2 different fields below the "Analytics Scripts":
- Generic Script
- Form selector
We recommend not to compile them and ask (if necessary) to the Integration Team if it's possible to use them to make some customization.
Enable additional functions (Coupon Code, Fiscal Code, Marketing Option, etc)
After you Go live with Magic, you can proceed enabling Coupon Code, Fiscal Code and Marketing Option fields and adding your Privacy and Cookie Policy and Terms&Conditions: you can find more info consulting the Merchant Portal instructions.
Magic Checkout Placement advice
For best product performance, Magic Checkout should appear as follows:
Product Page
Direct above the Add to Cart buttonCart Page
Directly above the Checkout buttonMini Cart
Directly above the Checkout button
Updated 10 months ago