METANORM AI Address Validation

METANORM AI Address Validation checks and suggests corrections for both billing and shipping addresses in WooCommerce Classic Checkout, Block Checkout, and My Account address forms.

When customers submit a checkout or save a billing or shipping address in My Account, the plugin sends the required address fields to the configured Metanorm server. The server applies configured validation rules, processes the address through the selected validation and geocoding providers, and returns a normalized result.

Customers can review suggested corrections directly in the checkout or account address form and choose whether to use the suggestion or keep their entered address.

The plugin is designed as a lightweight WooCommerce connector. Provider credentials, validation rules, prompt construction, AI integration, and geocoding integration remain on the Metanorm server.

Features

• Supports both billing and shipping addresses in WooCommerce Classic Checkout and Block Checkout.
• Address validation when customers edit billing or shipping addresses in My Account.
• Server-side address validation and normalization.
• Support for rule-based validation.
• Support for geocoding-assisted validation.
• Display of suggested address corrections.
• Authenticated communication with the configured Metanorm server.
• No intentional local persistence of submitted address-validation requests by the plugin.

External Services

This plugin requires a paid METANORM subscription and an API key. The plugin itself is free; address validation is performed by the external service, not unlocked locally.

Service and account registration: https://metanorm.ai/login
Terms of service: https://metanorm.ai/agb
Privacy policy: https://metanorm.ai/datenschutz
Support and contact: https://metanorm.ai/#contact
Service provider legal notice: https://bieber-systems.com/impressum

When address validation is requested, the plugin sends the address fields required for validation to that service. Depending on the server configuration, the service may process the submitted information through external AI and geocoding providers.

The transmitted data may include:

• Address line 1 (street and house number).
• Address line 2 (additional address information).
• Postal code, city and country code.
• A two-letter browser language code and a random request identifier.

The API key is sent in the Authorization header. Dedicated name, company, email, telephone and state fields are not sent to the validation API. Address lines may contain personal information entered by the customer.

Requests are made when a customer submits a checkout or saves an account address and validation is required. Without a saved API key, the plugin does not send addresses to the service. The administrator’s Test connection button makes a separate request to /healthz without an API key or address data.

The plugin does not need direct access to the credentials of the underlying AI or geocoding providers. These credentials remain on the configured Metanorm server.

See the linked service terms and privacy policy for retention and subprocessors. If the service URL is overridden, the shop operator must provide the corresponding service information to customers. Shop operators should describe address validation in their own privacy notice.

The plugin logs request identifiers, HTTP status, duration and fixed diagnostic codes, but not address payloads or API keys. For abuse prevention it temporarily stores a keyed hash of the connection IP address and request counts; the counters expire after one minute. Reverse-proxy headers are not trusted. Shops behind a proxy should enforce additional rate limits at their trusted edge.

Source Code

Readable JavaScript and SCSS sources are included in src/. Build configuration and dependency lockfiles are included in the plugin. See BUILDING.txt for requirements and commands to reproduce the compiled assets.