KSA National Address Validator

This plugin enhances the WooCommerce checkout experience by adding a “National Address Short Code” field. When a customer enters their 8-character short code, the plugin communicates with the OTO National Address API to fetch and automatically populate the checkout address fields (City, District, Street Address, etc.).

Features

• Adds a National Address Short Code field to the WooCommerce checkout page (Classic and Blocks).
• Field is shown only when Saudi Arabia is selected as the billing country.
• Validates the format of the short code (4 letters followed by 4 digits, e.g. ABCD1234).
• Fetches address details from the OTO API and auto-fills City, District, Street, Postcode fields.
• Optional: mark the field as required for Saudi Arabia orders only (non-SA orders are never blocked).
• Connect/disconnect via email and password login (supports 2FA/TOTP).
• Caches the API access token (55 minutes) to minimise API calls.
• Compatible with WooCommerce High-Performance Order Storage (HPOS).
• Fully compatible with both Classic checkout and WooCommerce Blocks checkout.

External services

This plugin connects to the OTO API to validate Saudi Arabian National Address short codes and retrieve address details during WooCommerce checkout.

What this service does

The OTO National Address API validates 8-character Saudi National Address short codes (e.g., ABCD1234) and returns the corresponding address information including city, district, street name, building number, and postal code. This data is used to automatically populate checkout address fields for customers in Saudi Arabia.

Data transmitted

During plugin authentication (admin settings page): – Email address and password are sent to authenticate with the OTO API – If 2FA is enabled, the one-time password (OTP) code is also sent – A refresh token is returned and stored to maintain the connection

During checkout validation (when customer enters a short code): – The National Address short code entered by the customer is sent to the API – An access token (obtained via the stored refresh token) is sent for authentication – Address data is returned and used to populate checkout fields

Service provider

This service is provided by OTO Global.

• Service website: https://tryoto.com/
• Terms and Conditions: https://www.tryoto.com/terms-and-conditions
• Privacy Policy: https://www.tryoto.com/privacy-policy