Use Laravel Cashier for Stripe subscriptions by installing it, publishing migrations, adding the Billable trait to the User model, creating subscriptions with a payment method, and handling webhooks via a defined route. 2. For one-time Stripe payments, install the Stripe PHP SDK, set environment variables, create a payment controller to process charges, and use Stripe.js to securely collect card details and generate tokens. 3. Integrate PayPal using the srmklive/paypal package by installing it, publishing configuration, setting up credentials, creating a controller to initiate and handle payments via ExpressCheckout, and defining success and cancel routes. 4. Follow security best practices by never handling raw card data, using environment variables for API keys, verifying webhook signatures, logging failed payments, and testing with sandbox accounts. 5. On the frontend, use Stripe.js to securely collect payment details by initializing Stripe, creating a card element, mounting it to the DOM, and generating a token on form submission to send to the Laravel backend. Laravel simplifies payment integration with secure, package-driven workflows for Stripe and PayPal when best practices are followed.

Handling payment gateways like Stripe or PayPal in Laravel is straightforward thanks to Laravel's ecosystem, available packages, and the official SDKs from these providers. Here’s how you can integrate and manage them effectively.

1. Using Laravel Cashier for Stripe (Recommended for Subscriptions)

If your app uses recurring billing or subscriptions, Laravel Cashier is the best way to handle Stripe.

Install Cashier

composer require laravel/cashier

Publish Migration and Run

Cashier provides migrations for storing subscription data:

php artisan cashier:install
php artisan migrate

Add Billable Trait to User Model

use Laravel\Cashier\Billable;

class User extends Authenticatable
{
    use Billable;
}

Subscribe a User

$user = Auth::user();

$paymentMethod = $request->input('payment_method'); // from Stripe.js

$user->newSubscription('default', 'price_monthly')->create($paymentMethod);

Handle Webhooks

Cashier automatically handles common Stripe webhooks (e.g., invoice.paid, subscription.canceled). Define a route:

Route::post('/stripe/webhook', function () {
    // Handled by Cashier
})->name('stripe.webhook');

Make sure to set up the webhook endpoint in the Stripe Dashboard.

2. Manual Stripe Integration (One-Time Payments)

For simple one-time payments without subscriptions, use the Stripe PHP SDK.

Install Stripe SDK

composer require stripe/stripe-php

Set Up Environment Variables

In .env:

STRIPE_KEY=pk_test_...
STRIPE_SECRET=sk_test_...

Create a Payment Controller

use Stripe\Stripe;
use Stripe\Charge;

class PaymentController extends Controller
{
    public function pay()
    {
        Stripe::setApiKey(env('STRIPE_SECRET'));

        $token = request('stripeToken');

        $charge = Charge::create([
            'amount' => 1000, // in cents
            'currency' => 'usd',
            'description' => 'Example charge',
            'source' => $token,
        ]);

        return redirect()->back()->with('success', 'Payment successful!');
    }
}

?? Use Stripe.js or Elements on the frontend to securely collect card details and generate a token.

3. PayPal Integration Using Srmklive/PayPal Package

Laravel doesn’t have a built-in PayPal solution like Cashier, but the srmklive/paypal package is widely used.

Install the Package

composer require srmklive/paypal:~3.0

Publish and Configure

php artisan vendor:publish --provider="Srmklive\PayPal\Providers\PayPalServiceProvider"

Update config/paypal.php with your PayPal sandbox/live credentials.

Use in Controller

use Srmklive\PayPal\Services\ExpressCheckout;

class PayPalController extends Controller
{
    public function pay()
    {
        $provider = new ExpressCheckout;

        $data = [];
        $data['items'] = [
            [
                'name' => 'Product 1',
                'price' => 10,
                'qty' => 1
            ]
        ];

        $data['return_url'] = route('paypal.success');
        $data['cancel_url'] = route('paypal.cancel');
        $data['invoice_id'] = uniqid();
        $data['total'] = 10;

        $response = $provider->setExpressCheckout($data);

        return redirect($response['paypal_link']);
    }

    public function success(Request $request)
    {
        $provider = new ExpressCheckout;
        $response = $provider->getExpressCheckoutDetails($request->token);

        if ($response['ACK'] == 'Success') {
            // Payment successful
        }

        return redirect('/')->with('success', 'Payment completed');
    }
}

Don’t forget to set up routes for paypal.success and paypal.cancel.

4. Security & Best Practices

• Never handle raw card data on your server. Always use Stripe.js, PayPal SDKs, or hosted fields.
• Use environment variables for API keys.
• Verify webhooks with proper signature checks.
• Log failed payments for debugging and user support.
• Test with sandbox accounts before going live.

5. Frontend Integration Tips

For Stripe:

<script src="https://js.stripe.com/v3/"></script>
<script>
    const stripe = Stripe('your-publishable-key');
    const elements = stripe.elements();
    const card = elements.create('card');
    card.mount('#card-element');
</script>

On form submit:

stripe.createToken(card).then(function(result) {
    if (result.error) {
        // Show error
    } else {
        // Send result.token.id to your Laravel backend
        document.getElementById('stripeToken').value = result.token.id;
        document.getElementById('paymentForm').submit();
    }
});

Basically, Laravel makes payment integration clean and secure — use Cashier for Stripe subscriptions, the official Stripe SDK for one-time payments, and srmklive/paypal for PayPal. Just keep credentials safe and always test in sandbox mode first.

The above is the detailed content of How to handle payment gateways like Stripe or PayPal in Laravel?. For more information, please follow other related articles on the PHP Chinese website!