Setting Up Magento 2

Setting Up Magento 2

Magento version 2.1.10 or above is required.
Since Magento is self-hosted and highly customizable, you are expected to have IT contacts who can manage and debug any issues that appear in your Magento installation or server as these are out of CartRover's control. If you do not, we recommend considering a cloud hosted shopping cart platform instead (eg: Shopify, BigCommerce, etc).

Integration Specs:

  • Supported functions:
    • Order Download
    • Shipment Confirmation - Detailed
    • Inventory Sync
  • Required Parameters
    • Store URL
    • Account email and Password

Step-by-step guide

  1. Go to CartRover and setup a new Magento cart or click Edit Setup for an existing one.
  2. Enter your Magento store URL.
  3. Click the Grant US API Access button.
    1. You will be directed to your Magento Admin page where you should login to your account if it is not done automatically.
    2. If you are not directed to the admin section, in the page that pops up, navigate to the Magento admin yourself. This is a Magento security feature. DO NOT close the CartRover tab.
    3. If you don't have login access yourself, Instead click Share Setup Link, enter the client's email and click Save. They will receive a setup email. Instructions for client to follow: Cart Setup Share
  4. Within the Magento admin section, go to System > Extensions > Integrations
  5. Click Add New Integration and then enter the following fields. The URL entries must match exactly!
    1. Name: CartRover (or another name that lets you know who this connection is for)
    2. Email:
    3. Callback URL: https://app.cartrover.com/call_back/Magento2
    4. Identity link URL: https://app.cartrover.com/
  6. Click API on the left hand side of the screen.
  7. Select the Sales, Catalog, Carts, Stores->Settings->Configuration->Inventory Section, Stores->Inventory->Sources, Stores->Attributes->Product and Stores->Attributes->Attribute set sections.

  8. Click Save at the top of the screen.
  9. Click the Activate link on the new line labeled CartRover
  10. Click Allow in the upper right.
  11. Close the CartRover window that pops up
  12. Confirm the connection and then return to the original CartRover page where you will be informed if the connection was successful. If CartRover does not display a Successful Authorization message, the following are common reasons:
    1. Too much time has passed between setup and clicking Activate. Remove the integration from Magento and start from scratch. Try to complete the entire install within a minute.
    2. Your web server is stripping off headers. Headers are required to connect to Magento2. Please work with your IT to make sure headers are not being removed by your web server.
    3. The Store Base URL setting is incorrect in your Magento settings. There may be extra directories in it, or it may be missing directories.
  13. Click OK at the bottom of the page to save.
By default, orders must have the order state of processing for CartRover to download them. Note that Magento has both a "status" and "state" field for orders. You can view and map your statuses to the desired state within Magento by going to Stores > Order Status. You can change the state or status that CartRover searches for in the CartRover Magento settings page.


Connection Issues
If the connection does not complete after following the steps above, check these most common issues you may need to fix on your Magento server:
  1. Your Magento Base URL setting is incorrect in Magento
  2. Your server is blocking or redirecting away from the following URLs:
    1. www.yourstore.com/oauth/token/request
    2. www.yourstore.com/oauth/token/access

    • Related Articles

    • Setting Up Magento

      These instructions are for Magento 1. The latest version of Magento is Magento 2. If you have Magento 2, the setup instructions for that version can be found here. You can view your current version of Magento by logging into the Admin panel and ...
    • Magento orders missing products

      Problem After upgrading Magento to version 1.9.3.0 or above, orders in CartRover no longer contain any products. The inventory sync may have stopped working as well. Solution This is caused by a bug in Magento. There are currently two options you ...
    • Invalid carrier specified - Magento

      Problem Could not upload tracking information to Magento because "Invalid carrier specified." This is caused when you ship orders using a carrier not defined in Magento. Solution Option 1: Add the missing carrier To solve the issue you need to add ...
    • Magento 2 Settings

      This page covers the various options that can be set in CartRover and in your Magento 2 account. CartRover Settings Setting Description Default Other Options Order Status Filter Only pull orders with the selected Order State/Status. Note: an order ...
    • Access Denied - Magento

      Problem Some Magento actions fail with "Access Denied". Example: Solution This is caused by the API user not being given enough permissions. Go to: System -> Web Services -> Users Look at which "Role" the API user is assigned to. Go to: System -> Web ...