Address Validation


ShipperHQ supports a variety of features around address validation including the ability to validate the address entered by your customers in the checkout, automatic address type lookup, and address suggestion. This will result in fewer orders being sent to incorrect addresses and reduce charges from carriers for invalid addressing.

This article provides an overview of our Address Validation feature as well as how to enable it and begin configuration.

Important Parts to Address Validation

  1. Dynamic Address Type Lookup

    Verifies that the address type is either business or residential. This can affect the cost of shipping significantly.

  2. Dynamic Address Validity

    Verifies if the delivery address is valid or invalid with either UPS or Fedex.

  3. Address Suggestion at Checkout

    If an address is ambiguous, prompts the user to select the correct address from suggested candidates

  4. Manual Residential/Commercial Selector

    Manual Residential Selector on the checkout, so customers can select whether their delivery address is residential or commercial. Requires the Address Type Selector Feature.

ShipperHQ includes all elements as part of it’s address validation service, although there are some differences in support across eCommerce Platforms.

Except for Address Suggestion and Manual Residential/Commercial Selector, all other address validation-related features of ShipperHQ require that you have connected an address validation service to your ShipperHQ account.

If you have installed either UPS or FedEx as a carrier, both of these provide address validation services and you do not need to connect any third party service. However, you will want to ensure your account has ‘address validation’ enabled specifically for web services.

If you do not have a UPS or FedEx account or do not wish to use their address validation services, you can use either of the third party address validation providers currently available in ShipperHQ: Experian and Loqate.

Supported eCommerce Platforms & Carriers

ShipperHQ Address Validation Support
Platform Dynamic Address Type Lookup Dynamic Address Validity Address Suggestion at Checkout ResidentialSelector
Magento 1 Yes -Result shown on order Yes -Result shown on order Displays address candidates Yes
Magento 2 Yes -Result shown on order No Requires Free Address Autocomplete Extension to show suggestion Yes
Zoey Yes -Result shown on order Yes -Result shown on order Displays address candidates Yes
Shopify Yes* No No No
BigCommerce Yes* No No No
WooCommerce Yes* No No No

*These platforms do not allow us to store this information in the order details, but the address has been validated.

Address Validation Setup and Troubleshooting

One of UPS, FedEx, Experian, or Loqate must be added in order to run Address Validation.

Enabling in ShipperHQ

To enable Address Validation in your store, you need to perform the following actions:

  1. Go to Features -> Address Validation and toggle the Feature to Enabled.
  2. Click the setting, which can be accessed via the Gear emblem.
  3. Under the Validation Provider dropdown, select the carrier/service you wish to use.
    NOTE: Only validated Address Validation carriers/services will show here.
  4. For legacy Magento 1, Magento 2 and Zoey users only: Select where you want address validation to be performed – checkout or address book, or both.
    Step 4 has been eliminated for most customers.
  5. Save the settings
    For UPS or FedEx, you may need to contact your carrier to ask them to enable access to the Address Validation API on your credentials.
    Please note: For FedEx Carriers, address validation must be enabled on your FedEx web services account. To ensure this step is completed, please call the FedEx help desk at 877-339-2774 and request ‘web services’ when prompted. Once a representative is assisting you, ask them to ‘enable address validation’ for your account.
  6. For Magento Users Only: Login to your Magento admin panel, navigate to the Catalog > ShipperHQ > Synchronize menu and perform a synchronization to add the configuration settings to your Magento system. You may also manually edit the customer’s address type on their account within Magento by going to Customers > All Customers > Edit customer > Addresses dropdown.

Once enabled, you will be able to see the results of this process in the Magento 1 order details.

Enabling Address Type on Your Carrier

If you wish to use the automatically determined address type for calls to your Carrier in order to retrieve more accurate results, you’ll need to enable this on each carrier.

  1. Go to ShipperHQ -> Carriers -> edit your UPS or Fedex Carrier
  2. Locate the Optional panel and scroll to the Additional Charges section.
  3. Check the box for Use Validated Address Type and select the backup ShipperHQ should default to if an address cannot be validated.
  4. Save the Carrier

Verifying Address Validation is Working on Magento 1.x or Zoey

Once you’ve followed the steps above you can confirm that this is working as expected within your Magento 1.x or Zoey admin panel.

In this example, the shipping address is an exact match with address validation service.

Other possible outcomes are:

  • Corrected Exact Match – some elements of the entered address were corrected by ShipperHQ
  • Near Match with Options – there a number of possible valid addresses
  • Customer Override – the customer did not accept the validated address(es) as correct and chose to use the address as entered
  • Exact Match – the address was valid as entered
  • Unchecked – the address has not been validated
  • Not Validated Percentage – this address was not validated due to percentage of address checks configured in ShipperHQ

Address Suggestion at Checkout [Magento/Zoey]

Address Validation in ShipperHQ includes the additional feature of showing address suggestions at checkout and in their account address book and allowing customers to choose an address candidate to correct their entered address. This is currently only supported on Magento 1 and only when using UPS, Experian, or Loqate for address validation.

Validating address

Magento Workflow:

  • If an address is valid, the customer moves through checkout or saving their address without any notification (silent). Status is saved as “EXACT_MATCH”
  • If an address is ambiguous, or has candidates, these are displayed
    • The customer can accept a candidate and this will replace the entered address, status is saved as “EXACT_MATCH”
    • The customer can override the candidates and save the address as entered, status is saved as “CUSTOMER_OVERRIDE”
  • If the address is invalid and no candidates can be found
    • The customer can edit the address and validation is performed again
    • The customer can continue with the entered address, the status is saved as “INVALID”
  • If an error occurs during validation, the status is saved as “ERROR” and this address will be validated the next time it is used
  • Once the order is placed, the validity of the address is displayed with the detailed shipping information on the order view.
  • The next time an address is used at checkout it will not be validated again

Alternatively for Magento 2, we provide an Auto-Complete feature that will provide a dropdown list of addresses from which the customer can choose their valid address.

Dynamic Address Type Lookup

ShipperHQ has the ability to dynamically look up the address type based on the address entered. This saves you having to rely on the customer to select the address type. If the address cannot be found it will use the default address type set on the carrier.

Percentage to Validate

In the settings for the Address Validation Feature, there is a field to set the “Percentage to Validate”, which defaults to 100%.
You can use this setting to allow a certain portion of addresses entered entered by customers to NOT be validated, so that you stay within your account limits you have for validation requests.
If you are unsure about this, we recommend leaving it at 100%.


If you are not seeing the rates change based on residential/business address then you are likely to have one of the following issues:

  1. You are not set up for Validation with your carrier. This is an extra service, so even if you get shipping rates you need to ensure you have validation enabled at an API level, check with the carrier customer service if unsure
  2. The address you are entering cannot be validated – on Magento you will see this being returned in the response log
  3. The configuration is not enabled, check your ShipperHQ settings to ensure feature enabled and enabled in the Carrier Settings, also check that you have sync’ed in Magento 1/2


We work within the boundaries as set by carriers or service providers. There are instances that they will mark an address as valid even when there are invalid parts to it. We cannot automatically correct for this. Please ensure you conduct your own testing as appropriate.

Was this doc helpful?