Skip to content

matusstafura/magento2-vatid-validation

Repository files navigation

🧾 Magento 2 VAT ID Validation

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:
before validation
With this module enabled:
after validation

✅ 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!

  1. Fork the repo
  2. Create a new branch:
git checkout -b feature/your-feature-name
  1. Make your changes
  2. Push to your fork:
git push origin feature/your-feature-name
  1. Open a pull request

📃 License

MIT


☕ Support

If you find this module helpful:

Buy Me A Coffee