Yelocate

Description

Yelocate improves WooCommerce checkout by validating customer addresses, email addresses, and phone numbers in real time using an external validation API.

The plugin works by collecting checkout field values in the browser and sending them to a server-side AJAX handler in WordPress. The handler securely calls the configured validation API and returns a normalised response displayed to the customer as an inline banner near the relevant field.

Each validation type (address, email, phone) can be enabled or disabled independently and configured with its own CSS selectors, so the plugin adapts to any checkout layout — classic WooCommerce or block-based.

External Services

This plugin connects to the Yelocate API (https://yelocate.com) to perform
real-time validation of addresses, email addresses, and phone numbers at
WooCommerce checkout.

What data is sent and when:

• Address validation — billing address fields (address line 1, address
  line 2, city, state/province, postcode, country) are sent to the API when
  the customer fills in their billing address at checkout. Only triggered for
  the 40 supported countries listed below; all other countries are silently
  skipped.
• Email verification — the email address entered in the billing email
  field is sent to the API as the customer types.
• Phone verification — the phone number entered in the billing phone
  field, along with the billing country code, is sent to the API when the
  customer leaves the field (on blur), provided at least 7 digits are present.

Each validation type can be independently disabled. No API calls are made for
disabled validation types. The API key is stored server-side and is never
exposed to the browser.

This service is provided by Yelosoftware:
* Terms of Service: https://yelocate.com/terms
* Privacy Policy: https://yelocate.com/privacy

Features

• Address validation — verifies billing address in real time; detects missing components, suggests field-level corrections, and silently skips unsupported countries
• Email verification — validates deliverability and detects disposable or malformed addresses as the customer types
• Phone verification — validates phone numbers on blur once at least 7 digits are present; passes the billing country as the region code for accurate international validation
• Server-side API calls — the API key is never exposed to the browser
• Works with both classic and block-based WooCommerce checkout
• Each validation type has its own configurable CSS selectors and banner mount point
• Per-type enable/disable toggles — only enabled validations trigger API calls
• Intelligent address diffing — for suggested addresses, the plugin compares entered vs. suggested values field by field; if the only differences are formatting or language conventions, the address is treated as valid
• Graceful handling of incomplete addresses and unsupported countries
• Fully configurable via WordPress Admin → Settings → Yelocate Validation

Supported Countries (Address Validation)

Address validation is only triggered for the following countries. For all other countries the plugin stays silent and no API call is made.

Argentina (AR), Austria (AT), Australia (AU), Belgium (BE), Bulgaria (BG), Brazil (BR), Canada (CA), Switzerland (CH), Chile (CL), Colombia (CO), Czechia (CZ), Germany (DE), Denmark (DK), Estonia (EE), Spain (ES), Finland (FI), France (FR), United Kingdom (GB), Croatia (HR), Hungary (HU), Ireland (IE), India (IN), Italy (IT), Japan (JP), Lithuania (LT), Luxembourg (LU), Latvia (LV), Mexico (MX), Malaysia (MY), Netherlands (NL), Norway (NO), New Zealand (NZ), Poland (PL), Puerto Rico (PR), Portugal (PT), Sweden (SE), Singapore (SG), Slovenia (SI), Slovakia (SK), United States (US)

Configuration

Shared

• API Key — authentication key generated in your Yelocate dashboard (https://yelocate.com). Sign up, purchase validation credits, and generate a key before configuring the plugin. The key is stored server-side and never sent to the browser.
• Strictness — controls address validation strictness (normal or strict)

Address Validation

• Enable address validation — tick to activate; untick to disable completely
• API URL — address validation endpoint
• Banner mount selector — CSS selector for the element above which the address banner is inserted
• Address line 1 selector
• Address line 2 selector (optional)
• City selector
• State / province selector (optional)
• Postcode selector
• Country selector

Typical WooCommerce (classic) selectors:

Address line 1: #billing_address_1
Address line 2: #billing_address_2
City: #billing_city
State: #billing_state
Postcode: #billing_postcode
Country: #billing_country
Banner mount: #billing_address_1_field

Email Verification

• Enable email verification — tick to activate
• API URL — email verification endpoint
• Banner mount selector — CSS selector for the element above which the email banner is inserted
• Email input selector — CSS selector for the email input field

Typical WooCommerce (classic) selectors:

Email input: #billing_email
Banner mount: #billing_email_field

Phone Verification

• Enable phone verification — tick to activate
• API URL — phone verification endpoint
• Banner mount selector — CSS selector for the element above which the phone banner is inserted
• Phone input selector — CSS selector for the phone input field

Validation fires when the customer leaves the phone field, provided at least 7 digits are present. The billing country is automatically passed as the region code.

Typical WooCommerce (classic) selectors:

Phone input: #billing_phone
Banner mount: #billing_phone_field

License

This plugin is licensed under the GPLv2 or later.

https://www.gnu.org/licenses/gpl-2.0.html