Subscription Plans Overview

CoinTrail comes with three pre-configured subscription tiers designed to monetize your cryptocurrency tracking platform:

Plan Features Comparison

The following table shows the default feature limits and capabilities for each subscription tier:

Creating a Subscription Plan

Follow these steps to create a new subscription plan or modify existing ones:

Step 1: Navigate to Subscription Plans

Go to Admin Panel > Subscriptions > Subscription Plans and click the "Create Plan" button.

Step 2: Basic Information

Fill in the plan details:

Step 3: Configure Pricing

Set the pricing for different billing cycles:

Step 4: Set Feature Limits

Configure the limits for each feature. Use -1 for unlimited:

// Feature limit configuration
max_price_alerts: 50       // Maximum price alerts (-1 for unlimited)
max_watchlist_items: 100   // Maximum watchlist coins
max_portfolios: 3          // Number of portfolios (0 = disabled)
max_portfolio_holdings: -1 // Holdings per portfolio (-1 = unlimited)
api_calls_per_month: 0     // API quota (0 = no API access)
max_webhooks: 0            // Webhook configurations

Step 5: Enable Feature Toggles

Toggle features on or off for the plan:

Managing User Subscriptions

Access user subscriptions at Admin Panel > Subscriptions > User Subscriptions.

Subscription Statuses

User subscriptions can have the following statuses:

Manual Subscription Assignment

Administrators can manually assign subscriptions to users for various reasons:

• Comp'd accounts for partners or influencers
• Resolving payment issues
• Customer service gestures
• Testing and development purposes

To manually assign a subscription:

1. Navigate to Admin Panel > Users
2. Find and select the user
3. Click "Assign Subscription" from the actions menu
4. Select the plan and set the expiration date
5. Save changes - the user will receive a notification email

Subscription Lifecycle

Understanding how subscriptions flow through different states:

New User Registration
        |
        v
    [FREE TIER] -----> [TRIAL] (if trial enabled)
        |                  |
        |  Purchase        |  Trial ends / Purchase
        v                  v
    [ACTIVE] <----------[ACTIVE]
        |
        |  Payment fails
        v
    [GRACE PERIOD] (3-7 days)
        |
        |  Payment fixed     User cancels
        v                        v
    [ACTIVE] <------------ [CANCELLED]
                                 |
                                 |  Period ends
                                 v
                             [EXPIRED] --> [FREE TIER]

Automatic Actions

• Payment Success: Subscription activated, confirmation email sent
• Payment Failed: Grace period starts (default: 3 days), notification sent
• Subscription Expires: User reverted to Free tier, expiration email sent
• User Cancels: Access continues until period end, cancellation confirmed
• Upgrade: Immediate access to new tier, prorated charge
• Downgrade: Takes effect at next billing cycle

SubscriptionService API

Use the SubscriptionService class to programmatically check user subscription status:

use App\Services\SubscriptionService;

class PriceAlertController extends Controller
{
    public function __construct(
        protected SubscriptionService $subscriptions
    ) {}

    public function store(Request $request)
    {
        $user = auth()->user();
        $currentCount = $user->priceAlerts()->count();

        // Check if user can create more alerts
        if (!$this->subscriptions->isWithinLimit($user, 'price_alerts', $currentCount)) {
            return back()->with('error', 'You have reached your price alert limit. Upgrade to add more.');
        }

        // Create the alert...
    }
}

Blade Directives

Use custom Blade directives for feature gating in views:

{{-- Check subscription tier --}}
@subscription('premium')
    <!-- Only visible to Premium and Pro users -->
    <div class="portfolio-widget">...</div>
@endsubscription

{{-- Check specific feature --}}
@feature('portfolio')
    <a href="/portfolio">My Portfolio</a>
@else
    <a href="/pricing" class="upgrade-prompt">
        Upgrade to unlock Portfolio
    </a>
@endfeature

{{-- Show ads only for free users --}}
@unless(auth()->user()->hasActiveSubscription())
    <div class="advertisement">...</div>
@endunless