emmanuelsaleem/laravel-stripe-manager

Complete Laravel Stripe management package with UI for customers, products, subscriptions and payments

dev-master 2025-09-25 17:03 UTC

Requires

• php: ^8.1
• laravel/cashier: ^13.0|^14.0|^15.0
• laravel/framework: ^9.0|^10.0|^11.0
• stripe/stripe-php: ^10.0|^11.0|^12.0|^13.0|^14.0|^15.0|^16.0

MIT

• Emmanuel Saleem

README

A comprehensive Laravel package for managing Stripe customers, products, subscriptions, and payments with a complete web interface.

🚀 Quick Start

Installation

1. Install the package via Composer:

composer require emmanuelsaleem/laravel-stripe-manager

1. Install required dependencies:

composer require laravel/cashier stripe/stripe-php

1. Publish and run migrations:

php artisan vendor:publish --provider="EmmanuelSaleem\LaravelStripeManager\StripeManagerServiceProvider" --tag="migrations"
php artisan migrate

1. Publish views (optional):

php artisan vendor:publish --provider="EmmanuelSaleem\LaravelStripeManager\StripeManagerServiceProvider" --tag="views"

1. Publish configuration:

php artisan vendor:publish --provider="EmmanuelSaleem\LaravelStripeManager\StripeManagerServiceProvider" --tag="config"

Note: The migration will automatically add a stripe_id column to your users table if it doesn't already exist.

Configuration

1. Add Stripe credentials to your .env file:

STRIPE_KEY=pk_test_your_publishable_key
STRIPE_SECRET=sk_test_your_secret_key
STRIPE_WEBHOOK_SECRET=whsec_your_webhook_secret
CASHIER_CURRENCY=usd

1. Update your User model to use Cashier and Stripe Manager:

// In your User model
use Laravel\Cashier\Billable;
use EmmanuelSaleem\LaravelStripeManager\Traits\HasStripeId;

class User extends Authenticatable
{
    use Billable, HasStripeId;
}

🌐 Web Interface Access

Once installed, you can access the complete web interface at:

Main Dashboard

http://yourdomain.com/stripe-manager

Available Routes

• Dashboard: /stripe-manager - Overview with statistics
• Products: /stripe-manager/products - Manage products and pricing
• Customers: /stripe-manager/customers - Manage customers and payment methods
• Subscriptions: /stripe-manager/subscriptions - Manage subscriptions
• Webhooks: /stripe-manager/webhooks - Webhook management and logs

Authentication Required

All routes require authentication. Make sure users are logged in before accessing the interface.

📋 Features

• ✅ Customer Management: Create, update, and manage Stripe customers
• ✅ Card Storage: Store and manage customer payment methods locally
• ✅ Product Management: Create and manage Stripe products with multiple pricing tiers
• ✅ Pricing Management: Assign and manage product pricing with recurring/one-time options
• ✅ Subscription Management: Create, update, cancel, and resume subscriptions
• ✅ Webhook Handler: Handle Stripe webhooks for payment events
• ✅ Web Interface: Complete UI for managing all Stripe resources
• ✅ Payment Tracking: Store and track subscription payments locally

💻 Programmatic Usage

Customer Service

use EmmanuelSaleem\LaravelStripeManager\Services\CustomerService;

$customerService = app(CustomerService::class);

// Create a customer
$user = User::find(1);
$customer = $customerService->createCustomer($user, [
    'name' => 'John Doe',
    'email' => '[e-mail]'
]);

// Store a payment method
$card = $customerService->storePaymentMethod($user, $paymentMethodId, $setAsDefault = true);

// Create setup intent for card collection
$setupIntent = $customerService->createSetupIntent($user);

Product Service

use EmmanuelSaleem\LaravelStripeManager\Services\ProductService;

$productService = app(ProductService::class);

// Create a product
$product = $productService->createProduct([
    'name' => 'Premium Subscription',
    'description' => 'Access to premium features',
    'active' => true
]);

// Create pricing for the product
$pricing = $productService->createProductPrice($product, [
    'unit_amount' => 1999, // $19.99 in cents
    'currency' => 'usd',
    'recurring' => [
        'interval' => 'month',
        'interval_count' => 1
    ],
    'nickname' => 'Monthly Premium'
]);

Subscription Service

use EmmanuelSaleem\LaravelStripeManager\Services\SubscriptionService;

$subscriptionService = app(SubscriptionService::class);

// Create a subscription
$subscription = $subscriptionService->createSubscription($user, $pricing, [
    'trial_days' => 14,
    'payment_method' => $paymentMethodId
]);

// Cancel a subscription
$subscriptionService->cancelSubscription($subscription, $immediately = false);

// Resume a subscription
$subscriptionService->resumeSubscription($subscription);

🔗 Webhook Setup

1. Configure webhook endpoint in Stripe Dashboard:

   • URL: https://yourdomain.com/stripe-manager/webhooks/handle
   • Events to send:
     • invoice.payment_succeeded
     • invoice.payment_failed
     • customer.subscription.created
     • customer.subscription.updated
     • customer.subscription.deleted
     • customer.subscription.trial_will_end

2. The webhook automatically handles:

   • Payment success/failure tracking
   • Subscription status updates
   • Local database synchronization

🗄️ Database Schema

The package creates the following tables:

• em_stripe_products - Stores Stripe products
• em_product_pricing - Stores product pricing information
• em_stripe_subscriptions - Stores subscription data
• em_subscription_payments - Tracks payment history
• em_stripe_cards - Stores customer payment methods

🧪 Testing

# Run package tests
vendor/bin/phpunit packages/emmanuelsaleem/laravel-stripe-manager/tests

🤝 Contributing

We welcome contributions! Here's how you can help:

Development Setup

1. Fork the repository
2. Clone your fork:

git clone https://github.com/yourusername/laravel-stripe-manager.git
cd laravel-stripe-manager

1. Install dependencies:

composer install

1. Create a feature branch:

git checkout -b feature/your-feature-name

1. Make your changes and add tests

2. Run tests:

vendor/bin/phpunit

1. Commit your changes:

git commit -m "Add your feature description"

1. Push to your fork:

git push origin feature/your-feature-name

1. Create a Pull Request

Contribution Guidelines

• Follow PSR-12 coding standards
• Add tests for new features
• Update documentation as needed
• Ensure all tests pass
• Use meaningful commit messages

📄 License

This package is open-sourced software licensed under the MIT license.

🆘 Support

For support, please:

• Create an issue on the GitHub repository
• Contact [e-mail]
• Connect on LinkedIn

📝 Changelog

v1.0.0

• Initial release
• Complete Stripe customer management
• Product and pricing management
• Subscription lifecycle management
• Webhook handling
• Payment tracking
• Web interface