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:

  1. Test all its functionalities including order checkout flow and refund flow
  2. Appearance of Magic Checkout on product, mini-cart and cart pages.
  3. Correctly insert the API key to go live.

Install your Prestashop Plugin

  1. Login at your admin panel with your credentials.

  1. After successfully login to backend admin, select from left navigation Module --> Module Manager

  1. On the module list page click on Upload a Module

  2. Click on Browse button and upload your Magic.zip file

  3. When you click on Install now button plugin will be uploaded and installed then you will be redirected to Magic configuration page.

  4. 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.

  1. 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/DisableStatus of the Magic Checkout Plugin
ModeSelect your environment Mode: Staging/Production
Merchant TokenProvided in your merchant onboarding email
Merchant Secret KeyProvided in your merchant onboarding email
Enable/disable Magic Checkout on Product PageEnable 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 PageEnable 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 PageEnable 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 CodeThe 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 StatusIndicate the Order Waiting Status before the customer finalizes payment.
Order StatusIndicate the Final Order Status after the customer finalizes payment.
Enable Magic Checkout in Specific CountriesMagic Checkout will be shown only in the selected countries.
Disable Specific Shipping Methods on Magic CheckoutSelect Shipping Methods not allowed inside Magic Checkout
Enable Magic Checkout in Specific CurrenciesMagic Checkout will be shown only in the selected currencies.
Disable Magic checkout in specific CategoriesMagic 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 ScriptsAll the Scripts used to track the Order flow
Button StyleAdd some style to the button. This style will be added to wrapper div of the button.
Enable Error LogsStatus 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