Configuring the ShipperHQ Magento 2 Extension


Setting up your website in ShipperHQ gives you the credentials you’ll need to connect your Magento ShipperHQ extension. This document walks you through the basic configuration steps required to connect with ShipperHQ and other configuration options available.

Configuration options are located at Stores > Configuration > Sales > Shipping Methods > ShipperHQ

Basic Configuration Steps

  • Enter API Key And Authentication Code created in ShipperHQ.
    (This information is located under Websites in ShipperHQ under the new website you set up for your store.)
  • Select Environment Scope to match your ShipperHQ environment scope setting
  • Save the configuration settings
  • Set Enabled to “Yes” and disable all other shipping methods in Magento, this will prevent unexpected results at checkout.


ShipperHQ Configuration Options
Field Name Description
Main Shipping Carrier Title Carrier title displayed when no other carrier title is returned from ShipperHQ
Environment Scope Select the environment scope you have configured in ShipperHQ dashboard
API Key Unique identifier in ShipperHQ for your website
Authentication Code Unique code to authenticate this website with ShipperHQ
Backup Carrier/Method Select a standard Magento shipping carrier to act as a backup, in the unlikely event that ShipperHQ is not responding
Advanced Settings Panel
Field Name Description
Custom Shipping Rates in Admin Allow admin users to set a custom shipping rate when placing orders via the admin panel
Hide Carrier Notifications At Checkout Some carriers include additional information along with their rates. Use this setting to hide these notifications
Display Transaction ID ShipperHQ support may advise you to use this setting to aid debugging
Require Zipcode to Request Rates Only request shipping rates from ShipperHQ, if a zipcode has been entered in the cart or checkout – this helps to lower the number of API requests
Enable Caching of ShipperHQ Rates Allow ShipperHQ to cache shipping rate requests to minimise API requests
Timeout (seconds) Set timeout period in seconds to wait for ShipperHQ to return rates before calling backup carrier
Sandbox URL DO NOT EDIT – URL to connect to sandbox or test ShipperHQ environment
Secure URL DO NOT EDIT – URL to securely connect to live ShipperHQ environment
Sandbox Mode Select Yes to use sandbox or test ShipperHQ environment
Standard Shipping Panel
Field Name Description
Calculate Handling Fee Handling fee type
Handling Fee Enter fee or leave blank for no fee
Ship to Applicable Countries Limit ShipperHQ to selected countries or all countries
Ship to Specific Countries Select applicable countries for ShipperHQ carrier
Show Method if Not Applicable Display notification from ShipperHQ if no rates are returned
Sort Order Sort order of ShipperHQ rates in Magento
Displayed Error Message Text to be displayed if ShipperHQ does not return a response
Debug Enable additional logging and front end display to aid debugging