Integrating Stripe into your Laravel application allows you to accept payments seamlessly.
Step 1: Install Laravel Cashier
Laravel Cashier is a package that provides an interface for managing subscriptions and handling payments with Stripe. First, install Laravel Cashier:
bash
1 |
composer require laravel/cashier |
Step 2: Configure Stripe Credentials
You need to set up your Stripe API keys in your Laravel application. First, create a Stripe account at Stripe. Then, obtain your API keys from the Stripe Dashboard.
Open your .env
file and add your Stripe API keys:
plaintext
1 2 |
STRIPE_KEY=your_stripe_public_key STRIPE_SECRET=your_stripe_secret_key |
Step 3: Publish Cashier Configuration
Next, publish the Cashier configuration file using the following command:
bash
1 2 |
STRIPE_KEY=your_stripe_public_key STRIPE_SECRET=your_stripe_secret_key |
This will create a config/cashier.php
file, where you can configure additional settings if necessary.
Step 4: Set Up Database Migration
If you haven’t done so, you’ll need to add the required fields to your users
table to store Stripe information. Run the migration command:
bash
1 |
php artisan migrate |
You may need to create a new migration to add fields like stripe_id
, card_brand
, card_last_four
, trial_ends_at
, etc., to the users
table.
Here’s an example migration:
bash
1 |
php artisan make:migration add_stripe_fields_to_users_table --table=users |
In the migration file, add the following code:
php
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
public function up() { Schema::table('users', function (Blueprint $table) { $table->string('stripe_id')->nullable(); $table->string('card_brand')->nullable(); $table->string('card_last_four')->nullable(); $table->timestamp('trial_ends_at')->nullable(); }); } public function down() { Schema::table('users', function (Blueprint $table) { $table->dropColumn(['stripe_id', 'card_brand', 'card_last_four', 'trial_ends_at']); }); } |
Then run the migration:
bash
1 |
php artisan migrate |
Step 5: Set Up Routes
Define routes for handling the payment process. Open routes/web.php
and add the following routes:
php
1 2 3 4 |
use App\Http\Controllers\PaymentController; Route::get('/payment', [PaymentController::class, 'index'])->name('payment.index'); Route::post('/payment', [PaymentController::class, 'store'])->name('payment.store'); |
Step 6: Create Payment Controller
Create a controller to handle the payment logic:
bash
1 |
php artisan make:controller PaymentController |
In the PaymentController
, add the following methods:
php
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 |
<?php namespace App\Http\Controllers; use Illuminate\Http\Request; use Illuminate\Support\Facades\Auth; use Stripe\Stripe; use Stripe\Charge; class PaymentController extends Controller { public function index() { return view('payment.index'); } public function store(Request $request) { // Validate request $request->validate([ 'amount' => 'required|numeric', 'currency' => 'required|string', 'stripeToken' => 'required|string', ]); // Set the Stripe secret key Stripe::setApiKey(env('STRIPE_SECRET')); try { // Create a charge Charge::create([ 'amount' => $request->amount * 100, // Amount in cents 'currency' => $request->currency, 'description' => 'Payment from Laravel App', 'source' => $request->stripeToken, 'receipt_email' => Auth::user()->email, ]); return redirect()->back()->with('success', 'Payment successful!'); } catch (\Exception $e) { return redirect()->back()->with('error', $e->getMessage()); } } } |
Step 7: Create Payment Form
Create a Blade view for the payment form at resources/views/payment/index.blade.php
:
html
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 |
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Payment</title> <script src="https://js.stripe.com/v3/"></script> </head> <body> <h1>Payment</h1> @if (session('success')) <div>{{ session('success') }}</div> @endif @if (session('error')) <div>{{ session('error') }}</div> @endif <form action="{{ route('payment.store') }}" method="POST" id="payment-form"> @csrf <input type="hidden" name="amount" value="10"> <!-- Amount in dollars --> <input type="hidden" name="currency" value="usd"> <div> <label for="card-element">Credit or Debit Card</label> <div id="card-element"></div> <div id="card-errors" role="alert"></div> </div> <button type="submit">Submit Payment</button> </form> <script> var stripe = Stripe('{{ env('STRIPE_KEY') }}'); var elements = stripe.elements(); var cardElement = elements.create('card'); cardElement.mount('#card-element'); cardElement.on('change', function(event) { var displayError = document.getElementById('card-errors'); if (event.error) { displayError.textContent = event.error.message; } else { displayError.textContent = ''; } }); var form = document.getElementById('payment-form'); form.addEventListener('submit', function(event) { event.preventDefault(); stripe.createToken(cardElement).then(function(result) { if (result.error) { var errorElement = document.getElementById('card-errors'); errorElement.textContent = result.error.message; } else { var hiddenInput = document.createElement('input'); hiddenInput.setAttribute('type', 'hidden'); hiddenInput.setAttribute('name', 'stripeToken'); hiddenInput.setAttribute('value', result.token.id); form.appendChild(hiddenInput); form.submit(); } }); }); </script> </body> </html> |
Step 8: Testing
- Visit the
/payment
route in your browser. - Enter test card details. You can use the following test card numbers provided by Stripe:
- Visa:
4242 4242 4242 4242
- MasterCard:
4000 0025 0000 3155
- American Express:
3782 8224 6310 005
- Visa:
- Submit the form. You should see a success message if the payment is processed successfully.
Step 9: Error Handling
Ensure to implement error handling for various scenarios, including network issues, payment failures, etc. You can customize the messages displayed to the user based on the exception received from Stripe.
Summary
You’ve successfully integrated Stripe API into your Laravel application! Here’s a quick recap of the steps:
- Install Laravel Cashier.
- Configure Stripe credentials in the
.env
file. - Publish Cashier configuration.
- Set up the database migration to store Stripe information.
- Create routes for handling payments.
- Create a PaymentController to manage payment logic.
- Create a payment form to collect payment details.
- Test the integration using Stripe’s test card numbers.
- Laravel Breeze – Simple authentication starter kit
- Laravel Jetstream – Scaffolding for Laravel apps
- Laravel Passport – API authentication via OAuth2
- Laravel Sanctum – Simple API authentication
- Spatie Laravel Permission – Role and permission management
- Laravel Cashier – Subscription billing with Stripe
- Laravel Scout – Full-text search using Algolia
- Laravel Socialite – OAuth authentication (Google, Facebook, etc.)
- Laravel Excel – Excel import and export for Laravel
- Laravel Horizon – Redis queues monitoring
- Laravel Nova – Admin panel for Laravel
- Laravel Fortify – Backend authentication for Laravel
- Laravel Vapor – Serverless deployment on AWS
- Laravel Telescope – Debugging assistant for Laravel
- Laravel Dusk – Browser testing
- Laravel Mix – API for compiling assets
- Spatie Laravel Backup – Backup management
- Laravel Livewire – Building dynamic UIs
- Spatie Laravel Media Library – Manage media uploads
- Laravel Excel – Excel spreadsheet handling
- Laravel Debugbar – Debug tool for Laravel
- Laravel WebSockets – Real-time communication
- Spatie Laravel Sitemap – Generate sitemaps
- Laravel Spark – SaaS scaffolding
- Laravel Envoy – Task runner for deployment
- Spatie Laravel Translatable – Multilingual model support
- Laravel Backpack – Admin panel
- Laravel AdminLTE – Admin interface template
- Laravel Collective Forms & HTML – Simplified form and HTML generation
- Spatie Laravel Analytics – Google Analytics integration
- Laravel Eloquent Sluggable – Automatically create slugs
- Laravel Charts – Chart integration
- Laravel Auditing – Track changes in models
- Laravel JWT Auth – JSON Web Token authentication
- Laravel Queue Monitor – Monitor job queues
- Spatie Laravel Query Builder – Filter, sort, and include relationships in Eloquent queries
- Laravel Datatables – jQuery Datatables API
- Laravel Localization – Multilingual support for views and routes
- Laravel Acl Manager – Access control list manager
- Laravel Activity Log – Record activity in your app
- Laravel Roles – Role-based access control
- Spatie Laravel Tags – Tagging models
- Laravel Installer – CLI installer for Laravel
- Laravel Breadcrumbs – Generate breadcrumbs in Laravel
- Laravel Mailgun – Mailgun integration for Laravel
- Laravel Trustup Model History – Store model change history
- Laravel Deployer – Deployment automation tool
- Laravel Auth – Custom authentication guards
- Laravel CORS – Cross-Origin Resource Sharing (CORS) support
- Laravel Notifications – Send notifications through multiple channels
- Spatie Laravel Http Logger – Log HTTP requests
- Laravel Permission Manager – Manage permissions easily
- Laravel Stubs – Customize default stubs in Laravel
- Laravel Fast Excel – Speed up Excel exports
- Laravel Image – Image processing
- Spatie Laravel Backup Server – Centralize backups for Laravel apps
- Laravel Forge API – Manage servers through the Forge API
- Laravel Blade SVG – Use SVGs in Blade templates
- Laravel Ban – Ban/unban users from your application
- Laravel API Response – Standardize API responses
- Laravel SEO – Manage SEO meta tags
- Laravel Settings – Store and retrieve settings
- Laravel DOMPDF – Generate PDFs
- Laravel Turbo – Full-stack framework for building modern web apps
- Spatie Laravel Event Sourcing – Event sourcing implementation
- Laravel Jetstream Inertia – Jetstream’s Inertia.js integration
- Laravel Envoy Tasks – Task automation
- Laravel Likeable – Like/dislike functionality
- Laravel GeoIP – Determine visitor’s geographic location
- Laravel Country State City – Dropdowns for country, state, and city
- Laravel Hashids – Generate short unique hashes
- Laravel Repository – Repository pattern for Laravel
- Laravel UUID – UUID generation for models
- Spatie Laravel Medialibrary Pro – Enhanced media management
- Laravel Queue Monitor – Monitor Laravel job queues
- Laravel User Activity – Monitor user activity
- Laravel DB Snapshots – Create database snapshots
- Laravel Twilio – Twilio integration
- Laravel Roles – Role-based permission handling
- Laravel Translatable – Add translations to Eloquent models
- Laravel Teamwork – Manage teams in multi-tenant apps
- Laravel Full Text Search – Add full-text search to Laravel models
- Laravel File Manager – File and media management
- Laravel User Timezones – Automatically detect user time zones
- Laravel ChartsJS – Render charts with ChartsJS
- Laravel Stripe – Stripe API integration
- Laravel PDF Generator – PDF generation
- Laravel Elasticsearch – Elasticsearch integration
- Laravel Simple Qrcode – Generate QR codes
- Laravel Timezone – Manage timezones and conversions
- Laravel Collective API – API management for Laravel
- Laravel Rest API Boilerplate – REST API starter kit
- Laravel Multi Auth – Multi-authentication functionality
- Laravel Voyager – Admin panel for Laravel
- Laravel Voyager Database – Database manager for Voyager
- Laravel Categories – Handle categories for models
- Laravel Multitenancy – Multi-tenancy implementation
- Laravel Access Control – Advanced access control for users
- Laravel Menus – Menu management
- Laravel Translatable Routes – Multilingual route handling