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.
557557
  1. After successfully login to backend admin, select from left navigation Module --> Module Manager
416416
  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.

13061306
  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.
979979

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

17801780

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 only in the selected currencies.

Disable Magic checkout in specific Categories

Magic Checkout will be shown in every categories except in the those selected.

Enable Error Logs

Status of the collectable Magic Checkout Error Logs

Shipping Methods

Select Shipping Methods to show and use in the Magic IFrame

Analytics Scripts

All the Scripts used to track the Order flow

🚧

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.

10751075

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