README 文档

README

Version: 0.1.0
Status: In Development
PHP: ^8.3
Extends: azaharizaman/nexus-payment

Overview

Nexus\PaymentRecurring is an extension package for Nexus\Payment providing subscription billing, usage-based billing, and recurring payment management. It supports payment schedules, billing cycles, proration, and dunning management.

Installation

composer require azaharizaman/nexus-payment-recurring

Features

Subscription Billing - Fixed, tiered, and per-seat pricing
Usage-Based Billing - Metered billing with thresholds
Payment Schedules - Weekly, monthly, quarterly, annual
Proration - Mid-cycle upgrades/downgrades
Dunning Management - Retry logic for failed payments
Trial Periods - Free trial with auto-conversion

Quick Start

use Nexus\PaymentRecurring\Contracts\SubscriptionManagerInterface;

final readonly class BillingService
{
    public function __construct(
        private SubscriptionManagerInterface $subscriptionManager,
    ) {}

    public function createSubscription(CreateSubscriptionRequest $request): Subscription
    {
        return $this->subscriptionManager->create($request);
    }

    public function processRenewals(): RenewalResult
    {
        return $this->subscriptionManager->processRenewals();
    }
}

Billing Models

Model	Description	Use Case
Fixed	Same amount each period	SaaS plans
Tiered	Volume-based pricing	API calls
Per-Seat	Per user/license	Enterprise software
Usage	Metered consumption	Utilities, Cloud

Documentation

License

MIT License. See LICENSE for details.

azaharizaman/nexus-payment-recurring 适用场景与选型建议

azaharizaman/nexus-payment-recurring 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 0 次下载、GitHub Stars 达 0，最近一次更新时间为 2026 年 05 月 04 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「payment」「subscription」「saas」「billing」「recurring」「ERP」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 azaharizaman/nexus-payment-recurring 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

azaharizaman/nexus-payment-recurring

包简介

关键字：