azaharizaman/nexus-payment

Framework-agnostic payment domain package providing unified payment entity, instruments, allocations, and event-driven integration for AR/AP/Payroll

v0.1.0-alpha1 2026-05-05 02:28 UTC

Requires

• php: ^8.3
• azaharizaman/nexus-common: dev-main
• psr/event-dispatcher: ^1.0
• psr/log: ^3.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^10.0

MIT

• Nexus Team

• payment
• Accounting
• ERP
• framework-agnostic
• payable
• allocation
• receivable

README

Version: 0.1.0
Status: In Development
PHP: ^8.3

Overview

Nexus\Payment is the core payment domain package providing a unified payment model for handling monetary transfers across Accounts Receivable, Accounts Payable, and Payroll domains. This package follows the Progressive Disclosure Pattern - it covers 80% of payment use cases, with extension packages available for advanced functionality.

Installation

composer require azaharizaman/nexus-payment

Features

• Unified Payment Entity - Single PaymentInterface spanning AR/AP/Payroll
• Payment Instruments - Bank accounts, cards, and wallet abstractions
• Allocation Engine - FIFO, LIFO, Proportional, Manual allocation strategies
• Event-Driven - Domain events for integration with other packages
• Multi-Tenant - Full tenant isolation
• Framework-Agnostic - Works with Laravel, Symfony, or any PHP framework

Quick Start

use Nexus\Payment\Contracts\PaymentPersistInterface;
use Nexus\Payment\Enums\PaymentDirection;
use Nexus\Payment\Enums\PaymentMethod;
use Nexus\Common\ValueObjects\Money;

final readonly class PaymentService
{
    public function __construct(
        private PaymentPersistInterface $paymentPersist,
    ) {}

    public function recordPayment(
        string $tenantId,
        string $payerId,
        Money $amount,
    ): string {
        // Implementation
    }
}

Extension Packages

For advanced functionality, see these extension packages:

Package	Purpose
azaharizaman/nexus-payment-rails	ACH, Wire, Check, RTGS payment rails
azaharizaman/nexus-payment-gateway	Stripe, PayPal, Square integrations
azaharizaman/nexus-payment-bank	NACHA, SWIFT, ISO 20022 bank files
azaharizaman/nexus-payment-wallet	Digital wallets (GrabPay, DuitNow)
azaharizaman/nexus-payment-recurring	Subscriptions and standing orders

Documentation

• Requirements
• Implementation Summary
• Test Suite Summary

License

MIT License. See LICENSE for details.