Plugin Installation & Configuration

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
Staging
Token
ea4db480-8a63-4b89-9a09-7e46f3092810
Secret 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 button
Cart Page
Directly above the Checkout button
Mini Cart
Directly above the Checkout button