Stripe Integration - Quote to Payment Cycle Laravel

Level 58

To implement a quote to payment cycle using Laravel with Stripe, you can follow these general steps. This approach will involve creating a quote, sending it to the customer for confirmation, and then processing the payment using Stripe. Laravel Cashier can be used for handling the payment part, but you'll need to handle the quote and confirmation logic yourself.

Step 1: Set Up Stripe and Laravel Cashier

Install Laravel Cashier: If you haven't already, install Laravel Cashier for Stripe.
```
composer require laravel/cashier
```

Configure Stripe: Add your Stripe API keys to your .env file.

STRIPE_KEY=your-stripe-key
STRIPE_SECRET=your-stripe-secret

Publish Cashier's Migrations: Run the following command to publish the necessary migrations.
```
php artisan vendor:publish --tag="cashier-migrations"
```
Run Migrations: Execute the migrations to create the necessary tables.
```
php artisan migrate
```

Step 2: Create a Quote System

Create a Quote Model and Migration: Generate a model and migration for quotes.
```
php artisan make:model Quote -m
```

Define the Quote Schema: In the migration file, define the necessary fields for a quote, such as customer_id, amount, status, etc.

Schema::create('quotes', function (Blueprint $table) {
    $table->id();
    $table->foreignId('customer_id')->constrained();
    $table->decimal('amount', 8, 2);
    $table->string('status')->default('pending');
    $table->timestamps();
});

Run the Migration: Apply the migration to create the quotes table.
```
php artisan migrate
```

Step 3: Implement Quote Confirmation

Create a Controller for Quotes: Generate a controller to handle quote creation and confirmation.
```
php artisan make:controller QuoteController
```

Add Methods for Quote Creation and Confirmation:

public function createQuote(Request $request)
{
    $quote = Quote::create([
        'customer_id' => $request->customer_id,
        'amount' => $request->amount,
        'status' => 'pending',
    ]);

    // Send quote to customer for confirmation (e.g., via email)
    // ...

    return response()->json(['quote' => $quote]);
}

public function confirmQuote($quoteId)
{
    $quote = Quote::findOrFail($quoteId);
    $quote->status = 'confirmed';
    $quote->save();

    // Proceed to payment
    return redirect()->route('payment.process', ['quote' => $quote]);
}

Step 4: Process Payment with Stripe

Create a Payment Controller: Generate a controller to handle payments.
```
php artisan make:controller PaymentController
```

Add a Method to Process Payments:

public function processPayment(Quote $quote)
{
    $user = auth()->user();

    // Ensure the quote is confirmed
    if ($quote->status !== 'confirmed') {
        return redirect()->back()->withErrors('Quote not confirmed.');
    }

    // Create a payment intent
    $paymentIntent = $user->createSetupIntent();

    return view('payment.form', [
        'intent' => $paymentIntent,
        'quote' => $quote,
    ]);
}

public function handlePayment(Request $request, Quote $quote)
{
    $user = auth()->user();

    // Charge the customer
    $user->charge($quote->amount * 100, $request->paymentMethodId);

    // Update quote status
    $quote->status = 'paid';
    $quote->save();

    return redirect()->route('payment.success');
}

Create a Payment Form View: Create a Blade view to handle the payment form and Stripe elements.

<!-- resources/views/payment/form.blade.php -->
<form id="payment-form" method="POST" action="{{ route('payment.handle', $quote) }}">
    @csrf
    <input type="hidden" name="paymentMethodId" id="paymentMethodId">
    <button id="card-button" data-secret="{{ $intent->client_secret }}">
        Pay {{ $quote->amount }}
    </button>
</form>

<script src="https://js.stripe.com/v3/"></script>
<script>
    const stripe = Stripe('{{ env('STRIPE_KEY') }}');
    const elements = stripe.elements();
    const cardElement = elements.create('card');
    cardElement.mount('#card-element');

    const cardButton = document.getElementById('card-button');
    const clientSecret = cardButton.dataset.secret;

    cardButton.addEventListener('click', async (e) => {
        e.preventDefault();
        const { setupIntent, error } = await stripe.confirmCardSetup(
            clientSecret, {
                payment_method: {
                    card: cardElement,
                    billing_details: { name: 'Customer Name' }
                }
            }
        );

        if (error) {
            // Display error.message in your UI.
        } else {
            document.getElementById('paymentMethodId').value = setupIntent.payment_method;
            document.getElementById('payment-form').submit();
        }
    });
</script>

Conclusion

This setup provides a basic flow for creating quotes, confirming them, and processing payments using Stripe in a Laravel application. You can expand upon this by adding more features such as email notifications, detailed quote items, and more robust error handling.