Integrate PayPal in Laravel 12

Introduction

Online payments are an essential part of modern web applications, and PayPal is one of the most trusted payment gateways worldwide. Whether you’re building an eCommerce store, a subscription-based service, or a donation platform, integrating PayPal in Laravel 12 can help you securely accept payments. In this guide, we’ll walk through the step-by-step process of integrating PayPal in Laravel 12 using the PayPal REST API.

Let’s get started!

Step 1: Install Laravel 12

If you haven’t already set up Laravel 12, create a new Laravel project using Composer:

composer create-project laravel/laravel paypal-integration

Navigate to your project directory:

cd paypal-integration

Step 2: Install PayPal SDK

To communicate with PayPal, we need to install the PayPal REST API SDK via Composer:

composer require paypal/rest-api-sdk-php

This package allows Laravel to interact with PayPal’s API for handling payments.

Step 3: Get PayPal API Credentials

1. Visit the PayPal Developer Dashboard: developer.paypal.com
2. Log in and create a new app in the Sandbox environment.
3. Copy the Client ID and Secret Key—we’ll need these for configuration.

Step 4: Configure PayPal in Laravel

Open the .env file and add your PayPal credentials:

PAYPAL_CLIENT_ID=your-client-id
PAYPAL_SECRET=your-secret-key
PAYPAL_MODE=sandbox  # Use 'live' for production

Now, update config/services.php to include PayPal configuration:

return [
    'paypal' => [
        'client_id' => env('PAYPAL_CLIENT_ID'),
        'secret' => env('PAYPAL_SECRET'),
        'settings' => [
            'mode' => env('PAYPAL_MODE', 'sandbox'),
            'http.ConnectionTimeOut' => 30,
            'log.LogEnabled' => true,
            'log.FileName' => storage_path('logs/paypal.log'),
            'log.LogLevel' => 'ERROR',
        ],
    ],
];

Step 5: Create a PayPal Controller

Run the following command to create a new controller:

php artisan make:controller PayPalController

Open app/Http/Controllers/PayPalController.php and add the following code:

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use PayPal\Auth\OAuthTokenCredential;
use PayPal\Rest\ApiContext;
use PayPal\Api\Amount;
use PayPal\Api\Payer;
use PayPal\Api\Payment;
use PayPal\Api\PaymentExecution;
use PayPal\Api\RedirectUrls;
use PayPal\Api\Transaction;

class PayPalController extends Controller
{
    private $apiContext;

    public function __construct()
    {
        $this->apiContext = new ApiContext(
            new OAuthTokenCredential(
                config('services.paypal.client_id'),
                config('services.paypal.secret')
            )
        );
        $this->apiContext->setConfig(config('services.paypal.settings'));
    }

    public function createPayment()
    {
        $payer = new Payer();
        $payer->setPaymentMethod('paypal');

        $amount = new Amount();
        $amount->setTotal('10.00'); 
        $amount->setCurrency('USD');

        $transaction = new Transaction();
        $transaction->setAmount($amount);
        $transaction->setDescription('Laravel PayPal Payment');

        $redirectUrls = new RedirectUrls();
        $redirectUrls->setReturnUrl(route('paypal.success'))
                     ->setCancelUrl(route('paypal.cancel'));

        $payment = new Payment();
        $payment->setIntent('sale')
                ->setPayer($payer)
                ->setTransactions([$transaction])
                ->setRedirectUrls($redirectUrls);

        try {
            $payment->create($this->apiContext);
            return redirect()->away($payment->getApprovalLink());
        } catch (\Exception $e) {
            return redirect()->route('paypal.cancel')->with('error', 'Something went wrong!');
        }
    }

    public function successPayment(Request $request)
    {
        if (!$request->has('paymentId') || !$request->has('PayerID')) {
            return redirect()->route('paypal.cancel')->with('error', 'Payment failed');
        }

        $payment = Payment::get($request->paymentId, $this->apiContext);
        $execution = new PaymentExecution();
        $execution->setPayerId($request->PayerID);

        try {
            $payment->execute($execution, $this->apiContext);
            return redirect()->route('paypal.success')->with('success', 'Payment successful');
        } catch (\Exception $e) {
            return redirect()->route('paypal.cancel')->with('error', 'Payment failed');
        }
    }

    public function cancelPayment()
    {
        return redirect('/')->with('error', 'Payment cancelled');
    }
}

Step 6: Define Routes

Open routes/web.php and add the following routes:

use App\Http\Controllers\PayPalController;

Route::get('/paypal', [PayPalController::class, 'createPayment'])->name('paypal.create');
Route::get('/paypal/success', [PayPalController::class, 'successPayment'])->name('paypal.success');
Route::get('/paypal/cancel', [PayPalController::class, 'cancelPayment'])->name('paypal.cancel');

Step 7: Create a Payment Button

To trigger PayPal payment, create a button in your view file resources/views/paypal.blade.php:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>PayPal Integration in Laravel 12</title>
</head>
<body>

    <h2>Pay with PayPal</h2>

    @if(session('success'))
        <p>{{ session('success') }}</p>
    @endif

    @if(session('error'))
        <p>{{ session('error') }}</p>
    @endif

    <a href="{{ route('paypal.create') }}">
        <button>Pay with PayPal</button>
    </a>

</body>
</html>

Step 8: Test the Payment

Run your Laravel project:

php artisan serve

Visit http://127.0.0.1:8000/paypal and click the Pay with PayPal button. If everything is set up correctly, you’ll be redirected to PayPal to complete the payment.

Integrating PayPal in Laravel 12 is simple and efficient with the PayPal REST API. This setup allows you to securely accept payments in your application. Whether you’re running an online store or offering digital services, this integration helps streamline transactions.

For professional Laravel development services, CodeHunger provides tailored web solutions to meet your needs.