Plugin Configuration

Follow these installation steps to install and configure Magic Checkout

Enable Magic Checkout Plugin

To enable Magic Checkout go to:

Stores → Configuration → Sales→ Payment Methods

Find Magic under Payment Methods

1: Select Magic in the payment tab
2: Select Basic Settings accordion
3: Toggle Enabled dropdown to Yes
4: Click on the Save Config button

API Configuration

Stores → Configuration → Sales→ Payment Methods → Magic

ModeSelect "Staging" for the test version of the module and switch to "Production" to put Magic Checkout live
Merchant TokenStaging -> Provided in the box below the table

Production ->Provided in your merchant onboarding email
Secret keyStaging -> Provided in the box below the table

Production ->Provided in your merchant onboarding email
Enable Error LogEnable to collect all the logs produces by Magic

NB It's recommended in staging mode only

Enable Magic Checkout - Product, Mini-Cart, Cart Page

In order to have Magic Checkout available across your ecommerce 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 ecommerce store may not have a Mini-Cart enabled or available to its customers. If this is the case, then this step is optional.

Basic Settings to configure Magic Checkout

Stores → Configuration → Sales → Magic → Basic Settings

EnableEnable Magic Checkout payment
TitleAdd the title to the Payment
Order Waiting StatusIndicate the Order Waiting Status before the customer finalizes payment
Final Order StatusIndicate the Final Order Status after the customer finalizes payment
Product Page - Toggle MagicEnable Magic Checkout to show on Product page
Product Page selectors (for rendering Magic button)HTML element selector where to show Magic Checkout below on the Product Page
Cart page - Toggle MagicEnable Magic Checkout to show on Cart page
Cart Page selectors (for rendering Magic button)HTML element selector where to show Magic Checkout below on the Cart Page
Mini Cart Page - Toggle MagicEnable Magic Checkout to show on Mini cart. (note This switch will be disabled if there are any disabled categories selected in the properly configuration field described below)
Mini Cart Page selectors (for rendering Magic button)HTML element selector where to show Magic Checkout below on the Mini-Cart
Show Fiscal Code in order informationShow Fiscal Code in the Account Information section of the order detail page in CMS.

NB For compatibility with previous versions of this module. If you have already updated to 2.0.0 the fiscal code is showed inside the billing address
Payment from Applicable CountriesFilter countries to enable Magic Checkout
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. (note If there are selected categories the Mini-cart will be always disabled)
Magic Checkout Analytics ScriptsAll the Scripts used to track the Order flow

📘

Staging Environment

Mode
Staging

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

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

Displaying Magic Checkout Using Page Selectors

You must specify relevant page selectors so that the Magic Checkout button is correctly rendered on your product, mini-cart and cart page.

Magic Checkout plugin uses these selectors in order to correctly render on each of the pages on the ecommerce store.

👍

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

Clear Magento 2 Cache

Flush the Magento 2 Cache after performing the plugin installation and configuration.
After you have flushed the cache proceed to Plugin Testing: Orders & Refunds

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.