Plugin Installation & Configuration

❗️
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
Order Status	Status of the Order purchased with Magic
Mode	Select your environment Mode: Staging/Production
Merchant Token	Provided in your merchant onboarding email
Merchant Secret Key	Provided in your merchant onboarding email
Product Page - Toggle Magic	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
Cart Page - Toggle Magic	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
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.
Enable Magic Checkout in Specific Currencies	Magic Checkout will be shown in every categories except in the those selected.
Enable Error Logs	Status of the collectable Magic Checkout Error Logs
Analytics Scripts	All the Scripts used to track the Order flow

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