misaf / vendra-transaction

v1.12.3 2026-08-22 21:15 UTC

Requires

• php: ^8.4
• flowframe/laravel-trend: ^0.5.0
• lara-zeus/spatie-translatable: ^2.0.1
• misaf/vendra-multimedia: v1.12.3
• misaf/vendra-support: v1.12.3
• spatie/eloquent-sortable: ^5.0.1
• spatie/laravel-activitylog: ^5.0
• spatie/laravel-model-states: ^2.11
• spatie/laravel-package-tools: ^1.93.1
• spatie/laravel-queueable-action: ^2.17
• spatie/laravel-sluggable: ^4.0.2

Suggests

• misaf/vendra-currency: Install this in the host application to manage active currencies used by wallet provisioning and transaction forms.

MIT

• Ehsan Mahmoodi

• laravel
• transaction
• filamentphp
• vendra
• misaf

Published on Packagist.org on 2026-08-23 06:13 UTC

README

Wallet and ledger based financial transactions for Vendra: per-user, per-currency wallet balances, an immutable ledger, a state-machine transaction lifecycle with multi-gateway support, and a Filament admin cluster for transactions, gateways, and wallets.

Features

1. Each user holds one Wallet per currency (created on first use via TransactionService::walletFor() / defaultWalletFor()), with a cached balance in the currency's minor units.
2. The ledger is the single source of balance truth: every movement is an immutable LedgerEntry (signed amount, balance_after snapshot, polymorphic source) written by PostLedgerEntryAction together with the cached wallet balance under a row lock. Overdrafts throw InsufficientBalanceException.
3. A Transaction is a gateway-facing money movement created through CreateTransactionAction::execute(), which enforces per-wallet TransactionLimits and attaches optional fee and metadata rows. Its amount is always absolute; the ledger sign derives from the transaction type (deposit, withdrawal, commission, transfer, bonus).
4. The lifecycle is a Spatie model-states machine: Pending → Processing → Review → Approved / Declined / Failed, driven by approve(), decline(), fail(), markProcessing(), and markReview(). Settlement into the ledger happens exactly once, inside the transition to Approved — principal, mirrored transfer credit, and fee commit atomically with the status change.
5. Gateways are admin-managed labels (translatable name and description, a scalar slug lookup key, logo, sortable position); payment-processing logic lives in the host application. Internal movements use the internal-transactions gateway.

The module is decoupled from concrete user and currency packages. The wallet owner model resolves from auth.providers.users.model; currency options resolve through the provider-neutral capability in misaf/vendra-support.

Requirements

• PHP 8.4+
• Laravel 13
• Filament 5
• misaf/vendra-support
• misaf/vendra-multimedia

Optional:

• misaf/vendra-currency — supplies managed active/default currency options to the shared Support resolver

Installation

composer require misaf/vendra-transaction
php artisan vendor:publish --tag=vendra-transaction-migrations
php artisan migrate

Optional translations publish:

php artisan vendor:publish --tag=vendra-transaction-translations

Balance verification

Recompute cached wallet balances from the ledger and report (or repair) drift:

php artisan vendra-transaction:verify-balances
php artisan vendra-transaction:verify-balances --repair

Testing

Run the package checks from the project root:

php artisan test --compact --testsuite=vendra-transaction
composer stan

License

MIT. See LICENSE.