README

A lightweight module that adds client-side VAT ID validation to key Magento 2 forms like checkout and customer address forms. This is helpful for EU country based commerce, that needs to verify VAT ID via VIES.

📋 Description

Magento 2 by default allows invalid or incorrectly formatted VAT IDs during checkout, which can lead to customer entry errors and issues with tax/VAT compliance like VIES check.

This module adds smart VAT ID validation per country, using patterns based on the official EU formats.

Default Magento 2 behavior:

With this module enabled:

✅ Features

Validates VAT ID format based on the selected country
Works on:
- 🛒 Checkout (shipping & billing addresses)
Translation-ready (i18n/sk_SK.csv and %1 placeholders supported)
Fully frontend (JS-based) — no backend override

📦 Installation

Option 1: Composer (Recommended)

composer require matusstafura/magento2-vatid-validation

Option 2: Manual Installation (for testing or customization)

git clone https://github.com/matusstafura/magento2-vatid-validation.git app/code/MatusStafura/VatIdValidation

Then run:

bin/magento module:enable MatusStafura_VatIdValidation
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

🚀 TODO

⏳ Option to override per store (via admin config)

🤝 Contributing

Contributions are welcome!

Fork the repo
Create a new branch:

git checkout -b feature/your-feature-name

Make your changes
Push to your fork:

git push origin feature/your-feature-name

Open a pull request

📃 License

MIT

☕ Support

If you find this module helpful:

matusstafura / magento2-vatid-validation

Maintainers

Details