Finova 1.4.18

Finova

<div align="center">

The Offline Financial Validation Toolkit for .NET

IBAN · BIC · Payment Cards · Payment References · VAT · Business Numbers · Securities

100% Offline · Zero Dependencies · Lightning Fast

🌐 Visit the Official Website

</div>

✨ Why Finova?

📦 Quick Installation

# Main package
dotnet add package Finova

# FluentValidation integration (optional)
dotnet add package Finova.Extensions.FluentValidation

🚀 Feature Overview

🏦 Banking & Cards

📝 Payment References

🏢 Business Numbers

🆔 National Identity

📊 Securities Identifiers (New in v1.4.0)

🌍 Country Support

Europe (51 Countries & Territories)

Global Expansion (v1.4.0)

🔧 Usage Examples

Basic Validation

using Finova.Core.Iban;
using Finova.Core.PaymentCard;
using Finova.Core.Identifiers;
using Finova.Services;

// Global IBAN Validation (supports all IBAN-enabled countries worldwide)
var result = GlobalIbanValidator.ValidateIban("BR1800360305000010009795493C1");
if (result.IsValid)
{
    Console.WriteLine("Valid Brazilian IBAN!");
}

// Country-specific IBAN Validation
var ibanService = new IbanService();
var result = ibanService.Validate("BE68 5390 0754 7034");

if (result.IsValid)
{
    var details = ibanService.Parse("BE68 5390 0754 7034");
    Console.WriteLine($"Country: {details.CountryCode}");
    Console.WriteLine($"BBAN: {details.Bban}");
    Console.WriteLine($"Check Digits: {details.CheckDigits}");
}

// BBAN Validation (Basic Bank Account Number)
var bbanService = serviceProvider.GetRequiredService<IBbanService>();
var bbanResult = bbanService.Validate("BE", "539007547034");

if (bbanResult.IsValid)
{
    var bbanDetails = bbanService.Parse("BE", "539007547034");
    Console.WriteLine($"Country: {bbanDetails.CountryCode}"); // BE
    Console.WriteLine($"BBAN: {bbanDetails.Bban}");           // 539007547034
}

// Payment Card Validation
var cardValidator = new PaymentCardValidator();
var cardResult = cardValidator.Validate("4111111111111111");

if (cardResult.IsValid)
{
    var cardDetails = cardValidator.Parse("4111111111111111");
    Console.WriteLine($"Brand: {cardDetails.Brand}"); // Visa
}

// ISIN Validation (Securities)
var isinValidator = new IsinValidator();
var isinResult = isinValidator.Validate("US0378331005");

if (isinResult.IsValid)
{
    var isinDetails = isinValidator.Parse("US0378331005");
    Console.WriteLine($"Country: {isinDetails.CountryCode}"); // US
    Console.WriteLine($"NSIN: {isinDetails.Nsin}");           // 037833100
}

Dependency Injection

using Finova.Extensions;

// Register all Finova services
services.AddFinova();

// Or register specific services
services.AddFinovaCore();
services.AddFinovaCountry<BelgiumModule>();

public class PaymentService
{
    private readonly IIbanService _ibanService;
    private readonly IVatValidator _vatValidator;

    public PaymentService(IIbanService ibanService, IVatValidator vatValidator)
    {
        _ibanService = ibanService;
        _vatValidator = vatValidator;
    }

    public bool ValidatePaymentDetails(string iban, string vatNumber)
    {
        return _ibanService.Validate(iban).IsValid
            && _vatValidator.Validate(vatNumber).IsValid;
    }
}

FluentValidation Integration

using Finova.Extensions.FluentValidation;

public class PaymentRequestValidator : AbstractValidator<PaymentRequest>
{
    public PaymentRequestValidator()
    {
        // 🏦 Banking
        RuleFor(x => x.Iban).MustBeValidIban();
        RuleFor(x => x.Bic).MustBeValidBic();

        // 🇺🇸🇨🇦🇦🇺🇸🇬🇯🇵 Routing Numbers (Aliases)
        RuleFor(x => x.UsRoutingNumber).MustBeValidABARoutingNumber();       // US ABA
        RuleFor(x => x.CaTransitNumber).MustBeValidCanadianTransitNumber(); // Canada
        RuleFor(x => x.AuBsb).MustBeValidAustralianBsb();                   // Australia BSB
        RuleFor(x => x.SgBankCode).MustBeValidSingaporeBankCode();          // Singapore
        RuleFor(x => x.JpZengin).MustBeValidJapanZenginCode();              // Japan

        // 💳 Payment Cards
        RuleFor(x => x.CardNumber).MustBeValidPaymentCard();
        RuleFor(x => x.VisaNumber).MustBeValidPaymentCardForBrand(PaymentCardBrand.Visa);

        // 🏢 Enterprise & Tax IDs (Aliases)
        RuleFor(x => x.Siret).MustBeValidSiret();                           // France SIRET
        RuleFor(x => x.Siren).MustBeValidSiren();                           // France SIREN
        RuleFor(x => x.Kbo).MustBeValidKbo();                               // Belgium KBO/BCE
        RuleFor(x => x.VatNumber).MustBeValidVat();                         // EU VAT

        // 📝 Payment References
        RuleFor(x => x.Communication).MustBeValidIsoRf();                   // ISO 11649 RF
        RuleFor(x => x.Ogm).MustBeValidOgm();                               // Belgian OGM
        RuleFor(x => x.QrRef).MustBeValidSwissQrReference();                // Swiss QR
    }
}

Country-Specific Validation

using Finova.Countries.Belgium;
using Finova.Countries.UnitedStates;

// Belgian validations
var belgiumIban = new BelgiumIbanValidator();
belgiumIban.Validate("BE68 5390 0754 7034"); // ✓

var belgiumVat = new BelgiumVatValidator();
belgiumVat.Validate("BE0123456789"); // ✓

var belgiumNationalId = new BelgiumNationalIdValidator();
belgiumNationalId.Validate("85.07.30-033.28"); // ✓

// US validations
var usRouting = new UnitedStatesRoutingNumberValidator();
usRouting.Validate("021000021"); // ✓

var usEin = new UnitedStatesEinValidator();
usEin.Validate("12-3456789"); // ✓

📋 Validation Rules Reference

IBAN Structure

Payment Card Validation

ISIN Structure

📊 Test Coverage

Total Tests: 10,700+
Passing: 100%
Countries Covered: 110+
Validators: 100+

🗺️ Roadmap

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines for details.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

🙏 Acknowledgments

• Financial standards: ISO 13616 (IBAN), ISO 9362 (BIC), ISO 6166 (ISIN), ISO 17442 (LEI)
• European Banking Authority for IBAN registry
• GLEIF for LEI standards
• Community contributors

<div align="center">

Made with ❤️ by Florian Di Vrusa

⭐ Star on GitHub · 📦 NuGet Package · 🌐 Website

</div>