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 with Staging configurations first.

Appearance of Magic Checkout on product, mini-cart and cart pages.

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

Login to your Admin platform:

After successfully login to backend admin go to System -> Configuration -> Sales -> Magic

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.

Mode	Select "Staging" for the test version of the module and switch to "Production" to put Magic Checkout live
Magic widget cdn	Select your environment Mode: Staging/Production
Merchant Token	Staging -> Provided in the blue box above Production -> Provided in your merchant onboarding email
Secret key	Staging -> Provided in the blue box above Production -> Provided in your merchant onboarding email
Product Page - Toggle Magic	Enable 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 Magic	Enable 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 Magic	Enable 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 Scripts	All the Scripts used to track the Order flow
Hide Magic button for Product Types	Select all product types for which you do not want to display Magic
Hide Magic button for Categories	Select all Categories for which you do not want to display Magic
Display Prices Incl. Tax	Select one of the values if you want to see prices including or excluding taxes

Enable Magic Checkout plugin

To enable Magic Checkout go to:

System → Configuration → Sales → Payment 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

Enable	Enable Magic Checkout Payment
Enabled	Status of the Magic Checkout Plugin
Title	Add the title to the Payment
New Order status	Select the status of the order when is captured
Payment from Applicable Countries	Filter 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.