Download the PHP package emmanuelsaleem/laravel-stripe-manager without Composer

Laravel Stripe Manager

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 in your Laravel project:

Navigate to your Laravel application directory:

Then install the package:

For a specific version:

For the latest development version:

Important: The migration will automatically add a stripe_id column to your users table if it doesn't already exist. No additional User model setup is required!

2. Install required dependencies:

3. Publish and run migrations:

4. Publish views (optional):

5. Publish configuration:

Configuration

1. Add Stripe credentials to your .env file:

🌐 Web Interface Access

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

Main Dashboard

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
• Subscriptions Sync: /stripe-manager/subscriptions-sync - Import existing Stripe subscriptions
• Stripe Testing: /stripe-manager/testing/stripe - Inspect Stripe customer data
• 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
• ✅ No Repeat Trial: Re-subscribing to the same plan skips free trial and charges immediately
• ✅ 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
• ✅ Multiple Payment Methods: Add, list, set default, and delete cards per customer
• ✅ Product Ordering: Drag-and-drop product ordering saved via display_order
• ✅ Subscriptions Sync: One-click sync of existing Stripe subscriptions into local DB, with skip report
• ✅ Stripe Testing Panel: Inspect Stripe customer, subs, invoices, PMs, next invoice, and recent charges
• ✅ Polished UI: Bootstrap 5 styling with a cohesive dark theme and improved pagination

🔌 API (Optional)

The package exposes a minimal REST API for integrating your frontend or other services. The base path and middleware are configurable.

API Documentation

Explore and test the REST API using the Postman documentation:

• Postman Docs: https://documenter.getpostman.com/view/21481838/2sB3QJNAb4

Configure

In config/stripe-manager.php:

Base URL: {APP_URL}/{prefix} (default: /api/stripe-manager)

Endpoints

1) GET {prefix}/plans

• Returns active products with active pricing from local DB (not Stripe).

Response

2) GET {prefix}/users/{userId}/subscription

• Returns latest subscription summary for a user (local DB), including next billing date and amount when available.

Response

3) POST {prefix}/select-subscription-plan

• Create subscription for user with optional payment method.

Body

Response

Behavior

• No repeat trial: if the user previously subscribed to the same pricing, the trial is skipped and the user is charged immediately.

4) GET {prefix}/trial-info?user_id=123

• Returns latest trial info (if any) for the user.

5) DELETE {prefix}/cancel-subscription-plan

• Cancels the current subscription. Optional immediately=true charges behavior is respected by service.

Body

6) GET {prefix}/user-payment-methods?user_id=123

• Lists card payment methods from Stripe for the user.

7) POST {prefix}/save-stripe-id

• Saves a known Stripe customer id on the user.

Body

8) POST {prefix}/set-default-payment-method

• Sets the user’s default payment method on Stripe.

Body

Notes

• Secure these endpoints by adding your preferred auth middleware (e.g. Sanctum) in api_routes.middleware.
• Amounts are in the smallest currency unit (e.g., cents).
• Trials are enforced locally and verified with Stripe when possible to prevent re-trial abuse.

💻 Programmatic Usage

Customer Service

Product Service

Subscription Service

🔗 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

Additional columns:

• em_stripe_products.display_order (uint, indexed) - for custom ordering

🧪 Testing

🤝 Contributing

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

Development Setup

1. Fork the repository

2. Clone your fork:

3. Install dependencies:

4. Create a feature branch:

5. Make your changes and add tests

6. Run tests:

7. Commit your changes:

8. Push to your fork:

9. 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.

❓ FAQ

Is the HasStripeId Trait Required?

No, the trait is optional. The package works without it by checking the stripe_id property directly. However, adding the trait provides helpful methods:

• With trait: The package checks $user->hasStripeId()
• Without trait: The package checks empty($user->stripe_id)

Both approaches work identically. The trait is a convenience helper.

What if I don't have a stripe_id column?

Run the migration provided with the package:

This will add the stripe_id column to your users table automatically.

🆘 Support

For support, please:

• Create an issue on the GitHub repository
• Contact [email protected]
• Connect on LinkedIn

⚙️ Advanced Configuration

Optional limits for Stripe API fetches (used by the testing panel):

These map to config/stripe-manager.php under stripe.limits.

🎛 Usage Tips

• Customer create page supports search + pagination for large user sets
• Manage multiple cards on a customer’s detail page (add, default, delete)
• Drag-and-drop products on the products list to reorder
• Run Subscriptions Sync to import historical data; skipped subscriptions (no matching local user) are shown with reasons

📝 Changelog

v1.0.0

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