Configuring Storefront Address Cleansing

Your Vertex Cloud account also includes the Vertex Address Cleansing module. When this functionality is enabled for your store, the storefront prompts the customer to correct the address information on both the shipping and billing steps of the one-page checkout and when the customer adds an address to their account.

Address message for correction

Using the storefront address cleansing requires that you first configure the Vertex Tax Calculations to connect to your Vertex Cloud account.

To enable Vertex address cleansing for the storefront:

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. To define the scope of the configuration for a multisite or multistore installation, set the Store View chooser in the upper-left corner to the specific website or store view that is to be configured.

  3. In the left panel, expand Sales and choose Address Cleansing.

  4. Set Vertex Address Cleansing to Enable.

    This setting allows you to configure the address cleansing settings.

    Address Cleansing settings - Enabled

  5. Verify and accept the default value for Address Validation API URL.

    This connects the integration with Vertex Cloud. The value should match the URL displayed in your Vertex Connectors page for the Commerce connector in the Address Lookup URL field.

  6. Leave the Trusted ID, which is populated from your Vertex Tax configuration.

  7. If you want to display a message when the address is correctly verified, set Confirmation Message When No Action Is Needed to Enable.

    By default, this function is disabled so that a message is displayed only if the address does not match a validated address with a prompt to correct it.

  8. When complete, click Save Config.

  9. To refresh the cache, do the following:

    • On the Admin sidebar, go to System > Tools > Cache Management.

    • Select the checkbox of each invalid cache.

    • Set Actions to Refresh and click Submit.