{"id":664,"date":"2025-09-05T12:02:14","date_gmt":"2025-09-05T12:02:14","guid":{"rendered":"https:\/\/1v0.net\/blog\/?p=664"},"modified":"2025-09-05T12:02:17","modified_gmt":"2025-09-05T12:02:17","slug":"how-to-build-a-subscription-system-with-stripe-and-laravel","status":"publish","type":"post","link":"https:\/\/1v0.net\/blog\/how-to-build-a-subscription-system-with-stripe-and-laravel\/","title":{"rendered":"How to Build a Subscription System with Stripe and Laravel?"},"content":{"rendered":"\n

Subscriptions are a common requirement for SaaS and membership-based applications. While Laravel Cashier provides a great abstraction for subscription billing, sometimes you want finer control over the subscription flow, especially when working directly with Stripe APIs. In this guide, we\u2019ll build a subscription system in Laravel with Stripe, covering plans, webhooks, billing UI, and subscription lifecycle management (start, cancel, resume). We\u2019ll also integrate Blade forms with Stripe Elements for secure payments.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Stripe Setup<\/strong><\/h2>\n\n\n\n

Create products and prices in your Stripe Dashboard. Each price ID (e.g., price_basic<\/code>, price_pro<\/code>) will represent a subscription plan. Then add your keys to .env<\/code>:<\/p>\n\n\n

STRIPE_KEY=pk_test_123\nSTRIPE_SECRET=sk_test_123<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n
Install Stripe\u2019s PHP SDK:<\/p>\n\n\n
composer require stripe\/stripe-php<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n
<\/div>\n\n\n\n
Database & User Model<\/strong><\/h2>\n\n\n\n
We\u2019ll store subscription details in the database so the app can track user subscriptions locally.<\/p>\n\n\n
php artisan make:migration create_subscriptions_table<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n
\/\/ database\/migrations\/xxxx_xx_xx_create_subscriptions_table.php<\/span>\nSchema::create('subscriptions'<\/span>, function<\/span> (Blueprint $table)<\/span> <\/span>{\n    $table->id();\n    $table->foreignId('user_id'<\/span>)->constrained()->onDelete('cascade'<\/span>);\n    $table->string('stripe_id'<\/span>);\n    $table->string('stripe_status'<\/span>);\n    $table->string('stripe_price'<\/span>);\n    $table->timestamp('ends_at'<\/span>)->nullable();\n    $table->timestamps();\n});<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
In your User<\/code> model, define a relation:<\/p>\n\n\n
public<\/span> function<\/span> subscription<\/span>()<\/span>\n<\/span>{\n    return<\/span> $this<\/span>->hasOne(\\App\\Models\\Subscription::class);\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
<\/div>\n\n\n\n
Subscription Controller<\/strong><\/h2>\n\n\n
php artisan make:controller StripeSubscriptionController<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n
\/\/ app\/Http\/Controllers\/StripeSubscriptionController.php<\/span>\nnamespace<\/span> App<\/span>\\Http<\/span>\\Controllers<\/span>;\n\nuse<\/span> App<\/span>\\Models<\/span>\\Subscription<\/span>;\nuse<\/span> Illuminate<\/span>\\Http<\/span>\\Request<\/span>;\nuse<\/span> Stripe<\/span>\\StripeClient<\/span>;\n\nclass<\/span> StripeSubscriptionController<\/span> extends<\/span> Controller<\/span>\n<\/span>{\n    protected<\/span> StripeClient $stripe;\n\n    public<\/span> function<\/span> __construct<\/span>()<\/span>\n    <\/span>{\n        $this<\/span>->stripe = new<\/span> StripeClient(config('services.stripe.secret'<\/span>));\n    }\n\n    public<\/span> function<\/span> index<\/span>(Request $request)<\/span>\n    <\/span>{\n        return<\/span> view('subscriptions.index'<\/span>, [\n            'intent'<\/span> => $request->user()->createSetupIntent(),\n            'plans'<\/span> => [\n                'Basic'<\/span> => 'price_basic'<\/span>,\n                'Pro'<\/span> => 'price_pro'<\/span>\n            ]\n        ]);\n    }\n\n    public<\/span> function<\/span> subscribe<\/span>(Request $request)<\/span>\n    <\/span>{\n        $request->validate([\n            'paymentMethod'<\/span> => 'required'<\/span>,\n            'price_id'<\/span> => 'required|string'<\/span>\n        ]);\n\n        $user = $request->user();\n        $customer = $this<\/span>->stripe->customers->create([\n            'email'<\/span> => $user->email,\n            'payment_method'<\/span> => $request->paymentMethod,\n            'invoice_settings'<\/span> => ['default_payment_method'<\/span> => $request->paymentMethod],\n        ]);\n\n        $subscription = $this<\/span>->stripe->subscriptions->create([\n            'customer'<\/span> => $customer->id,\n            'items'<\/span> => [['price'<\/span> => $request->price_id]],\n        ]);\n\n        Subscription::create([\n            'user_id'<\/span> => $user->id,\n            'stripe_id'<\/span> => $subscription->id,\n            'stripe_status'<\/span> => $subscription->status,\n            'stripe_price'<\/span> => $request->price_id,\n        ]);\n\n        return<\/span> redirect()->route('subscriptions.index'<\/span>)\n            ->with('success'<\/span>,'Subscription created!'<\/span>);\n    }\n\n    public<\/span> function<\/span> cancel<\/span>(Request $request)<\/span>\n    <\/span>{\n        $subscription = $request->user()->subscription;\n\n        if<\/span> ($subscription) {\n            $this<\/span>->stripe->subscriptions->cancel($subscription->stripe_id);\n            $subscription->update(['stripe_status'<\/span> => 'canceled'<\/span>]);\n        }\n\n        return<\/span> back()->with('success'<\/span>,'Subscription canceled.'<\/span>);\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
This controller handles creating customers, subscribing them to a plan, and canceling subscriptions. Webhooks should also be configured for status updates.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Routes<\/strong><\/h2>\n\n\n
\/\/ routes\/web.php<\/span>\nuse<\/span> App<\/span>\\Http<\/span>\\Controllers<\/span>\\StripeSubscriptionController<\/span>;\n\nRoute::middleware(['auth'<\/span>])->group(function<\/span> ()<\/span> <\/span>{\n    Route::get('\/subscriptions'<\/span>, [StripeSubscriptionController::class,'index'<\/span>])->name('subscriptions.index'<\/span>);\n    Route::post('\/subscriptions\/subscribe'<\/span>, [StripeSubscriptionController::class,'subscribe'<\/span>])->name('subscriptions.subscribe'<\/span>);\n    Route::post('\/subscriptions\/cancel'<\/span>, [StripeSubscriptionController::class,'cancel'<\/span>])->name('subscriptions.cancel'<\/span>);\n});<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
<\/div>\n\n\n\n
Blade Subscription Form<\/strong><\/h2>\n\n\n
<!-- resources\/views\/subscriptions\/index.blade.php -->\n<h2>Choose a Plan<\/h2>\n\n@if<\/span>(session('success'<\/span>))\n    <p style=\"color:green\"<\/span>>{{ session('success'<\/span>) }}<\/p>\n@endif<\/span>\n\n<form id=\"subscription-form\"<\/span> method=\"POST\"<\/span> action=\"{{ route('subscriptions.subscribe') }}\"<\/span>>\n    @csrf\n    <select name=\"price_id\"<\/span>>\n        @foreach<\/span>($plans as<\/span> $name => $id)\n            <option value=\"{{ $id }}\"<\/span>>{{ $name }}<\/option>\n        @endforeach<\/span>\n    <\/select>\n\n    <label>Card<\/label>\n    <div id=\"card-element\"<\/span>><\/div>\n\n    <input type=\"hidden\"<\/span> name=\"paymentMethod\"<\/span> id=\"payment-method\"<\/span> \/>\n    <button type=\"submit\"<\/span>>Subscribe<\/button>\n<\/form>\n\n<form method=\"POST\"<\/span> action=\"{{ route('subscriptions.cancel') }}\"<\/span>>\n    @csrf\n    <button>Cancel Subscription<\/button>\n<\/form>\n\n<script src=\"https:\/\/js.stripe.com\/v3\/\"<\/span>><\/script>\n<script>\nconst<\/span> stripe = Stripe('{{ config('<\/span>services.stripe.key') }}'<\/span>);\nconst<\/span> elements = stripe.elements();\nconst<\/span> card = elements.create('card'<\/span>);\ncard.mount('#card-element'<\/span>);\n\nconst<\/span> form = document.getElementById('subscription-form'<\/span>);\nform.addEventListener('submit'<\/span>, async (e) => {\n    e.preventDefault();\n    const<\/span> {paymentMethod, error} = await stripe.createPaymentMethod('card'<\/span>, card);\n    if<\/span> (error) {\n        alert(error.message);\n    } else<\/span> {\n        document.getElementById('payment-method'<\/span>).value = paymentMethod.id;\n        form.submit();\n    }\n});\n<\/script><\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
This form allows users to pick a plan, enter card details via Stripe Elements, and create a subscription securely.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Handling Webhooks<\/strong><\/h2>\n\n\n\n
Stripe will send events (invoice paid, subscription canceled, etc.) to your webhook endpoint. Configure in Stripe Dashboard and add a route in Laravel:<\/p>\n\n\n
\/\/ routes\/web.php<\/span>\nRoute::post('\/stripe\/webhook'<\/span>, \\Laravel\\Cashier\\Http\\Controllers\\WebhookController::class);<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Alternatively, create a custom controller to update your subscriptions<\/code> table based on events like customer.subscription.deleted<\/code>.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Wrapping Up<\/strong><\/h2>\n\n\n\n
We\u2019ve built a subscription system in Laravel with Stripe, covering plans, controllers, routes, Blade UI, and webhook handling. While Cashier provides a higher-level abstraction, rolling your own integration gives you more control over lifecycle events and custom billing logic. With this setup, you can extend functionality with plan upgrades, discounts, and multi-tenant billing features.<\/p>\n\n\n\n
<\/div>\n\n\n\n
What\u2019s Next<\/strong><\/h2>\n\n\n\n
Expand your subscription system with these guides:<\/p>\n\n\n\n