Moneyphp Percentage Laravel Package

Product Decisions This Supports

• Precision Financial Calculations: Enables accurate percentage-based calculations (e.g., VAT, discounts, fees) tied to monetary values, reducing rounding errors and ensuring compliance with financial regulations.
• Consistent Tax/Compliance Logic: Standardizes percentage calculations across applications (e.g., e-commerce, invoicing, or accounting tools), simplifying audits and reducing edge-case bugs.
• Build vs. Buy: Avoids reinventing a robust percentage-value-object layer for moneyphp/money, saving dev time and reducing technical debt.
• Roadmap for Localization: Supports future expansion into multi-currency or region-specific tax logic (e.g., EU VAT rates, US sales tax tiers).
• Use Cases:
  • Dynamic pricing engines (e.g., tiered discounts).
  • Automated tax calculation for global markets.
  • Subscription billing with variable percentage fees.

When to Consider This Package

• Avoid if:
  • Your app requires complex percentage logic beyond basic VAT/discounts (e.g., compound interest, progressive tax brackets). Consider custom solutions or libraries like phpmath/percentage.
  • You’re already using a monetary library with built-in percentage support (e.g., briannesbitt/Carbon + custom logic).
  • Your team lacks PHP/Laravel expertise to integrate value objects seamlessly.
• Look Elsewhere if:
  • You need real-time tax API integrations (e.g., Avalara, TaxJar). Use those services instead.
  • Your use case involves non-monetary percentages (e.g., user engagement metrics). This package is monetary-focused.

How to Pitch It (Stakeholders)

For Executives: "This lightweight package lets us handle taxes, fees, and discounts with precision—like a built-in calculator for financial percentages. It’s MIT-licensed, integrates with our existing moneyphp stack, and future-proofs compliance. Minimal dev effort, zero risk of calculation errors."

For Engineering: *"We’re adding a percentage value object to moneyphp/money to standardize VAT/discount logic. It’s a drop-in solution for:

• Tax calculations (e.g., EU VAT at 20%).
• Dynamic pricing (e.g., 10% off for bulk orders).
• Audit-friendly code with immutable objects. Pros: No reinvention, MIT license, active maintenance. Cons: Limited to basic percentage ops—extend if needed."*