Plugin Installation & Configuration

Follow these installation steps to install and configure Magic Checkout

❗️

IMPORTANT

Once you have installed and configured the plugin, be sure to:

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

Install your Magento 1 plugin

Please follow these installation steps to install Magic Checkout module by FTP/SFTP:

Step 1: Login on server by FTP/SFTP
Step 2: Copy all Magic Checkout folders and files and upload them in Magento root folder

❗️

IMPORTANT!

By default the test mode is enabled. You will need to enable the live after completing the testing.

Plugin Configuration

  1. Login to your Admin platform:
648
  1. After successfully login to backend admin go to System -> Configuration -> Sales -> Magic
269 972
  1. Check and change the configurations parameters you see in the table of "Magic settings parameters" paragraph of this doc and remember to set the Staging Environment endpoints first to make some test orders.

📘

Staging Environment endpoints

Mode
Staging

Token
ea4db480-8a63-4b89-9a09-7e46f3092810

Secret Key
e684a129-36a0-46d3-8176-801f797f06ab

You could add the Magic Checkout button in 3 different areas of your site:

1- Product Page
2- Mini-Cart
3- Cart Page

In order to have Magic Checkout available across your E-Commerce store you must set the following drop-down values to Yes:

Product Page - Toggle Magic

Cart Page - Toggle Magic

Mini Cart Page - Toggle Magic

Note Your E-Commerce store may not have a Mini-Cart enabled or available to its customers. If this is the case, then this step is optional.

Magic settings parameters

In the table below you can find the mapping of all attributes you can find in the Magic Checkout Configuration panel on the Admin panel.

ModeSelect "Staging" for the test version of the module and switch to "Production" to put Magic Checkout live
Magic widget cdnSelect your environment Mode: Staging/Production
Merchant TokenStaging -> Provided in the blue box above

Production -> Provided in your merchant onboarding email
Secret keyStaging -> Provided in the blue box above

Production -> Provided in your merchant onboarding email
Product Page - Toggle MagicEnable Magic Checkout to show on Product Page
Product page selector (for rendering Magic button)HTML element selector where to show Magic Checkout below
Cart Page - Toggle MagicEnable Magic Checkout to show on Cart page
Cart page selector (for rendering Magic button)HTML element selector where to show Magic Checkout below
Mini Cart Page - Toggle MagicEnable Magic Checkout to show on Mini Cart
Mini Cart page selector (for rendering Magic button)HTML element selector where to show Magic Checkout below
Magic Checkout Analytics ScriptsAll the Scripts used to track the Order flow
Hide Magic button for Product TypesSelect all product types for which you do not want to display Magic
Hide Magic button for CategoriesSelect all Categories for which you do not want to display Magic
Display Prices Incl. TaxSelect one of the values if you want to see prices including or excluding taxes

Enable Magic Checkout plugin

To enable Magic Checkout go to:

SystemConfigurationSalesPayment Methods

Find Magic under Payment Methods

1: Select Magic in the payment tab
2: Check and change New Order Status and/or Payment from Applicable Countries values (if you need)
3: Toggle Enabled dropdown to Yes
4: Click on the Save Config button

1172
EnableEnable Magic Checkout Payment
EnabledStatus of the Magic Checkout Plugin
TitleAdd the title to the Payment
New Order statusSelect the status of the order when is captured
Payment from Applicable CountriesFilter countries to enable Magic Checkout

👍

Magic Checkout Placement

For best product performance, Magic Checkout should appear as follows:

Product Page
Direct above the Add to Cart button

Mini-Cart Page
Directly above the View Cart / Checkout buttons

Cart Page
Directly above the Checkout button

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.

📘

Our Magic plugin is thought and developed to be ready out-of-the-box. If you have any problems or issue configuring your plugin, please contact us through your personal Jira Ticket.