PHPackages                             idoneo/humano-billing - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. idoneo/humano-billing

ActiveLibrary[Payment Processing](/categories/payments)

idoneo/humano-billing
=====================

Comprehensive billing and payment management system for Humano applications

1.1.0(7mo ago)0101AGPL-3.0BladePHP ^8.1

Since Oct 3Pushed 7mo agoCompare

[ Source](https://github.com/diego-mascarenhas/humano-billing)[ Packagist](https://packagist.org/packages/idoneo/humano-billing)[ Docs](https://github.com/diego-mascarenhas/humano-billing)[ RSS](/packages/idoneo-humano-billing/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (18)Versions (8)Used By (0)

Humano Billing Package
======================

[](#humano-billing-package)

[![Latest Version](https://camo.githubusercontent.com/34e695c6016bc2a934a96bed696e29b2f2ab562a7134d65a55d00653cd506bea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302e302d626c75652e737667)](CHANGELOG.md)[![Laravel](https://camo.githubusercontent.com/b4a5bfdc0b159e3198df12b156e735495966a34f1f23f5b181ed896f540de22d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d3130253230253743253230313125323025374325323031322d7265642e737667)](https://laravel.com)[![PHP](https://camo.githubusercontent.com/fb7c72456e13f7d5ecf8486e29d02a2e6775aaf4d18622a63529976b0ed0740e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532422d707572706c652e737667)](https://php.net)[![License](https://camo.githubusercontent.com/fc1337b376e0f126596ff974acff563406603ad7a5bac95781d31b512984fbdd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4147504c2d2d332e302d677265656e2e737667)](LICENSE)

Comprehensive billing and payment management system for Humano applications. This package provides a complete solution for managing invoices, payments, and accounting operations with multi-tenant support.

---

📦 Features
----------

[](#-features)

### Core Functionality

[](#core-functionality)

- ✅ **Invoice Management** - Full CRUD operations for invoices
- ✅ **Payment Tracking** - Comprehensive payment records with transaction types
- ✅ **Multi-Tenant** - Team-based isolation with global scopes
- ✅ **DataTables Integration** - Beautiful, searchable, sortable tables
- ✅ **Type Safety** - PHP 8.1 ENUMs for transaction types
- ✅ **Stripe Integration** - Via Laravel Cashier
- ✅ **Activity Logging** - Track all billing changes
- ✅ **Permissions** - Spatie Permission integration
- ✅ **Translations** - English and Spanish support

### Models

[](#models)

- `Invoice` - Main invoice records
- `InvoiceItem` - Line items for detailed billing
- `InvoiceType` - Purchase/Sale categorization
- `Payment` - Transaction records with status tracking
- `PaymentAccount` - Bank and payment account management
- `PaymentType` - 16 predefined payment methods

### Payment Methods Supported

[](#payment-methods-supported)

1. Cash
2. Bank Transfer
3. Bank Deposit
4. Check
5. Debit Card
6. Credit Card
7. PayPal
8. Stripe
9. Zelle
10. Venmo
11. Cash App
12. MercadoPago
13. Bank Draft
14. Wire Transfer
15. Other
16. N/A

---

📋 Requirements
--------------

[](#-requirements)

- PHP 8.1 or higher
- Laravel 10.x, 11.x, or 12.x
- MySQL 5.7+ or MariaDB 10.3+
- Composer

---

🚀 Installation
--------------

[](#-installation)

### Step 1: Install via Composer

[](#step-1-install-via-composer)

```
composer require idoneo/humano-billing
```

### Step 2: Publish Migrations

[](#step-2-publish-migrations)

```
php artisan vendor:publish --tag="humano-billing-migrations"
```

### Step 3: Run Migrations

[](#step-3-run-migrations)

```
php artisan migrate
```

### Step 4: Publish Configuration (Optional)

[](#step-4-publish-configuration-optional)

```
php artisan vendor:publish --tag="humano-billing-config"
```

### Step 5: Publish Views (Optional)

[](#step-5-publish-views-optional)

```
php artisan vendor:publish --tag="humano-billing-views"
```

---

📖 Usage
-------

[](#-usage)

### Basic Invoice Creation

[](#basic-invoice-creation)

```
use Idoneo\HumanoBilling\Models\Invoice;

$invoice = Invoice::create([
    'team_id' => auth()->user()->currentTeam->id,
    'enterprise_id' => $enterprise->id,
    'number' => 'INV-2025-001',
    'type_id' => 2, // Sale invoice
    'issue_date' => now(),
    'due_date' => now()->addDays(30),
    'subtotal' => 1000.00,
    'tax' => 150.00,
    'total' => 1150.00,
    'status' => 1, // Draft
]);
```

### Adding Invoice Items

[](#adding-invoice-items)

```
use Idoneo\HumanoBilling\Models\InvoiceItem;

InvoiceItem::create([
    'invoice_id' => $invoice->id,
    'service_id' => $service->id,
    'description' => 'Web Hosting - Monthly',
    'quantity' => 1,
    'unit_price' => 1000.00,
    'total' => 1000.00,
]);
```

### Recording Payments

[](#recording-payments)

```
use Idoneo\HumanoBilling\Models\Payment;
use Idoneo\HumanoBilling\Enums\TransactionType;

$payment = Payment::create([
    'team_id' => auth()->user()->currentTeam->id,
    'enterprise_id' => $enterprise->id,
    'invoice_id' => $invoice->id,
    'transaction_type' => TransactionType::INCOME,
    'date' => now(),
    'amount' => 1150.00,
    'type_id' => 2, // Bank Transfer
    'account_id' => $account->id,
    'status' => 2, // Approved
    'remarks' => 'Payment received',
]);
```

### Using Transaction Type ENUM

[](#using-transaction-type-enum)

```
use Idoneo\HumanoBilling\Enums\TransactionType;

// Get label
echo TransactionType::INCOME->label(); // "Income"
echo TransactionType::EXPENSE->label(); // "Expense"

// Get color
echo TransactionType::INCOME->color(); // "success"
echo TransactionType::EXPENSE->color(); // "danger"

// Get badge HTML
echo TransactionType::INCOME->badge(); //
```

---

🎨 DataTables
------------

[](#-datatables)

### Invoice DataTable

[](#invoice-datatable)

```
use Idoneo\HumanoBilling\DataTables\InvoiceDataTable;

public function index(InvoiceDataTable $dataTable)
{
    return $dataTable->render('humano-billing::invoices.index');
}
```

### Payment DataTable

[](#payment-datatable)

```
use Idoneo\HumanoBilling\DataTables\PaymentDataTable;

public function index(PaymentDataTable $dataTable)
{
    return $dataTable->render('humano-billing::payments.index');
}
```

---

🗄️ Database Schema
------------------

[](#️-database-schema)

### Invoices Table

[](#invoices-table)

- `id` - Primary key
- `team_id` - Foreign key to teams
- `enterprise_id` - Foreign key to enterprises
- `number` - Invoice number (unique per team)
- `type_id` - Foreign key to invoice\_types
- `issue_date` - Invoice issue date
- `due_date` - Payment due date
- `subtotal` - Subtotal amount
- `tax` - Tax amount
- `total` - Total amount
- `status` - Invoice status

### Payments Table

[](#payments-table)

- `id` - Primary key
- `team_id` - Foreign key to teams
- `enterprise_id` - Foreign key to enterprises
- `invoice_id` - Foreign key to invoices (nullable)
- `transaction_type` - ENUM (income, expense)
- `date` - Payment date
- `amount` - Payment amount (decimal 15,2)
- `type_id` - Foreign key to payment\_types
- `account_id` - Foreign key to payment\_accounts
- `status` - Payment status
- `remarks` - Additional notes

---

🔐 Permissions
-------------

[](#-permissions)

The package respects Laravel's authorization system. Make sure to define appropriate policies:

```
// In AuthServiceProvider
use Idoneo\HumanoBilling\Models\Invoice;
use App\Policies\InvoicePolicy;

protected $policies = [
    Invoice::class => InvoicePolicy::class,
];
```

---

🌍 Translations
--------------

[](#-translations)

The package includes translations for English and Spanish. Add your own translations by publishing the language files:

```
php artisan vendor:publish --tag="humano-billing-lang"
```

---

🧪 Testing
---------

[](#-testing)

```
cd packages/humano-billing
composer test
```

---

📝 Changelog
-----------

[](#-changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

---

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

---

🔒 Security
----------

[](#-security)

If you discover any security-related issues, please email  instead of using the issue tracker.

---

👨‍💻 Credits
-----------

[](#‍-credits)

- **Diego Adrián Mascarenhas Goytía** - [GitHub](https://github.com/diego-mascarenhas)

---

📄 License
---------

[](#-license)

The AGPL-3.0 License. Please see [License File](LICENSE) for more information.

---

💡 Support
---------

[](#-support)

For support, email  or open an issue on GitHub.

---

Made with ❤️ by [IDONEO](https://idoneo.net)

###  Health Score

35

—

LowBetter than 79% of packages

Maintenance69

Regular maintenance activity

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

7

Last Release

211d ago

Major Versions

v0.2.1 → 1.0.02025-10-06

### Community

Maintainers

![](https://www.gravatar.com/avatar/fa190334db1e228625e2df973f74328681cde2469306e3f6f7e519375e04a600?d=identicon)[idoneo](/maintainers/idoneo)

---

Top Contributors

[![diego-mascarenhas](https://avatars.githubusercontent.com/u/1038571?v=4)](https://github.com/diego-mascarenhas "diego-mascarenhas (14 commits)")

---

Tags

laravelbillingpaymentsinvoicingidoneohumano-billing

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/idoneo-humano-billing/health.svg)

```
[![Health](https://phpackages.com/badges/idoneo-humano-billing/health.svg)](https://phpackages.com/packages/idoneo-humano-billing)
```

###  Alternatives

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[musahmusah/laravel-multipayment-gateways

A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless

852.2k1](/packages/musahmusah-laravel-multipayment-gateways)[lanos/laravel-cashier-stripe-connect

Adds Stripe Connect functionality to Laravel's main billing package, Cashier.

84138.9k](/packages/lanos-laravel-cashier-stripe-connect)[danestves/laravel-polar

A package to easily integrate your Laravel application with Polar.sh

7812.3k](/packages/danestves-laravel-polar)[asciisd/knet

Knet package is provides an expressive, fluent interface to KNet's payment services.

141.1k](/packages/asciisd-knet)[threesquared/laravel-paymill

Laravel wrapper for the Paymill API

121.3k](/packages/threesquared-laravel-paymill)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)