{"id":341,"date":"2025-08-27T20:03:16","date_gmt":"2025-08-27T20:03:16","guid":{"rendered":"https:\/\/1v0.net\/blog\/?p=341"},"modified":"2025-08-27T20:03:18","modified_gmt":"2025-08-27T20:03:18","slug":"paypal-integration-in-laravel-step-by-step","status":"publish","type":"post","link":"https:\/\/1v0.net\/blog\/paypal-integration-in-laravel-step-by-step\/","title":{"rendered":"PayPal Integration in Laravel (Step by Step)"},"content":{"rendered":"\n

PayPal Integration in Laravel (Step by Step)<\/strong><\/h2>\n\n\n\n

PayPal remains one of the most widely used payment gateways globally. Integrating it into your Laravel app allows you to accept payments from millions of users. In this guide, we\u2019ll set up PayPal SDK, configure API credentials, create routes for checkout, handle webhooks for payment confirmation, and build a simple Blade UI to process PayPal transactions.<\/p>\n\n\n\n

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

1 – Install PayPal SDK<\/strong><\/h2>\n\n\n\n

Use Composer to install the official PayPal REST SDK.<\/p>\n\n\n

composer require paypal\/rest-api-sdk-php<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n
This package provides the classes you need to create payment requests, handle approvals, and confirm completed payments via PayPal APIs.<\/p>\n\n\n\n
<\/div>\n\n\n\n
2 – Configure PayPal Credentials<\/strong><\/h2>\n\n\n\n
Add your sandbox or live API credentials to .env<\/code>:<\/p>\n\n\nPAYPAL_CLIENT_ID=your-sandbox-client-id\nPAYPAL_SECRET=your-sandbox-secret\nPAYPAL_MODE=sandbox   # or live\n\n\n
Keep two sets of credentials: sandbox<\/code> for testing and live<\/code> for production. Never commit real secrets to your repository.<\/p>\n\n\n\n
<\/div>\n\n\n\n
3 – Create PayPal Service<\/strong><\/h2>\n\n\n\n
Encapsulate PayPal logic in a service class for cleaner controllers.<\/p>\n\n\n
\/\/ app\/Services\/PayPalService.php<\/span>\nnamespace<\/span> App<\/span>\\Services<\/span>;\n\nuse<\/span> PayPal<\/span>\\Rest<\/span>\\ApiContext<\/span>;\nuse<\/span> PayPal<\/span>\\Auth<\/span>\\OAuthTokenCredential<\/span>;\nuse<\/span> PayPal<\/span>\\Api<\/span>\\Amount<\/span>;\nuse<\/span> PayPal<\/span>\\Api<\/span>\\Payer<\/span>;\nuse<\/span> PayPal<\/span>\\Api<\/span>\\Payment<\/span>;\nuse<\/span> PayPal<\/span>\\Api<\/span>\\PaymentExecution<\/span>;\nuse<\/span> PayPal<\/span>\\Api<\/span>\\RedirectUrls<\/span>;\nuse<\/span> PayPal<\/span>\\Api<\/span>\\Transaction<\/span>;\n\nclass<\/span> PayPalService<\/span>\n<\/span>{\n    protected<\/span> $apiContext;\n\n    public<\/span> function<\/span> __construct<\/span>()<\/span>\n    <\/span>{\n        $this<\/span>->apiContext = new<\/span> ApiContext(\n            new<\/span> OAuthTokenCredential(\n                config('services.paypal.client_id'<\/span>),\n                config('services.paypal.secret'<\/span>)\n            )\n        );\n        $this<\/span>->apiContext->setConfig([\n            'mode'<\/span> => config('services.paypal.mode'<\/span>, 'sandbox'<\/span>),\n        ]);\n    }\n\n    public<\/span> function<\/span> createPayment<\/span>($amount, $currency = 'USD'<\/span>)<\/span>\n    <\/span>{\n        $payer = new<\/span> Payer();\n        $payer->setPaymentMethod('paypal'<\/span>);\n\n        $amountObj = new<\/span> Amount();\n        $amountObj->setTotal($amount)->setCurrency($currency);\n\n        $transaction = new<\/span> Transaction();\n        $transaction->setAmount($amountObj)->setDescription(\"Order Payment\"<\/span>);\n\n        $redirectUrls = new<\/span> RedirectUrls();\n        $redirectUrls->setReturnUrl(url('\/paypal\/success'<\/span>))\n                     ->setCancelUrl(url('\/paypal\/cancel'<\/span>));\n\n        $payment = new<\/span> Payment();\n        $payment->setIntent('sale'<\/span>)\n                ->setPayer($payer)\n                ->setTransactions([$transaction])\n                ->setRedirectUrls($redirectUrls);\n\n        return<\/span> $payment->create($this<\/span>->apiContext);\n    }\n\n    public<\/span> function<\/span> executePayment<\/span>($paymentId, $payerId)<\/span>\n    <\/span>{\n        $payment = Payment::get($paymentId, $this<\/span>->apiContext);\n        $execution = new<\/span> PaymentExecution();\n        $execution->setPayerId($payerId);\n\n        return<\/span> $payment->execute($execution, $this<\/span>->apiContext);\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
This service handles both creating a payment (with redirect URLs) and executing it after PayPal approves the transaction. Wrapping logic in a service keeps controllers lean.<\/p>\n\n\n\n
<\/div>\n\n\n\n
4 – Checkout Controller<\/strong><\/h2>\n\n\n\n
Create a controller to start the payment and handle PayPal redirects.<\/p>\n\n\n
\/\/ app\/Http\/Controllers\/PayPalController.php<\/span>\nnamespace<\/span> App<\/span>\\Http<\/span>\\Controllers<\/span>;\n\nuse<\/span> Illuminate<\/span>\\Http<\/span>\\Request<\/span>;\nuse<\/span> App<\/span>\\Services<\/span>\\PayPalService<\/span>;\n\nclass<\/span> PayPalController<\/span> extends<\/span> Controller<\/span>\n<\/span>{\n    protected<\/span> $paypal;\n\n    public<\/span> function<\/span> __construct<\/span>(PayPalService $paypal)<\/span>\n    <\/span>{\n        $this<\/span>->paypal = $paypal;\n    }\n\n    public<\/span> function<\/span> checkout<\/span>()<\/span>\n    <\/span>{\n        $payment = $this<\/span>->paypal->createPayment(19.99<\/span>);\n        return<\/span> redirect($payment->getApprovalLink());\n    }\n\n    public<\/span> function<\/span> success<\/span>(Request $request)<\/span>\n    <\/span>{\n        $paymentId = $request->query('paymentId'<\/span>);\n        $payerId = $request->query('PayerID'<\/span>);\n\n        $result = $this<\/span>->paypal->executePayment($paymentId, $payerId);\n\n        \/\/ Update DB: mark order as paid<\/span>\n\n        return<\/span> view('paypal.success'<\/span>, ['result'<\/span> => $result]);\n    }\n\n    public<\/span> function<\/span> cancel<\/span>()<\/span>\n    <\/span>{\n        return<\/span> view('paypal.cancel'<\/span>);\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
The checkout<\/code> method redirects users to PayPal. After approval, PayPal returns to success<\/code>, where we execute the payment and mark the order as paid. The cancel<\/code> method simply handles user cancellations.<\/p>\n\n\n\n
<\/div>\n\n\n\n
5 – Routes<\/strong><\/h2>\n\n\n\n
Add routes to connect the flow.<\/p>\n\n\n
\/\/ routes\/web.php<\/span>\nuse<\/span> App<\/span>\\Http<\/span>\\Controllers<\/span>\\PayPalController<\/span>;\n\nRoute::get('\/paypal\/checkout'<\/span>, [PayPalController::class, 'checkout'<\/span>]);\nRoute::get('\/paypal\/success'<\/span>, [PayPalController::class, 'success'<\/span>]);\nRoute::get('\/paypal\/cancel'<\/span>, [PayPalController::class, 'cancel'<\/span>]);<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
These routes cover the full PayPal checkout cycle: start, success, and cancel. In production, secure them with auth checks to link payments to logged-in users.<\/p>\n\n\n\n
<\/div>\n\n\n\n
6 – UI: PayPal Button<\/strong><\/h2>\n\n\n\n
You can use PayPal\u2019s JS SDK to render a checkout button instead of a simple link.<\/p>\n\n\n
<!-- resources\/views\/paypal\/checkout.blade.php --><\/span>\n@extends('layouts.app')\n\n@section('content')\n<div<\/span> class<\/span>=\"container\"<\/span>><\/span>\n  <h1<\/span>><\/span>Pay with PayPal<\/h1<\/span>><\/span>\n  <div<\/span> id<\/span>=\"paypal-button-container\"<\/span>><\/span><\/div<\/span>><\/span>\n<\/div<\/span>><\/span>\n\n<script<\/span> src<\/span>=\"https:\/\/www.paypal.com\/sdk\/js?client-id={{ config('services.paypal.client_id') }}&currency=USD\"<\/span>><\/span><\/script<\/span>><\/span>\n<script<\/span>><\/span>\npaypal.Buttons({\n  createOrder<\/span>: function<\/span>(<\/span>) <\/span>{\n    return<\/span> fetch('\/paypal\/checkout'<\/span>)\n      .then(res<\/span> =><\/span> res.text());\n  },\n  onApprove<\/span>: function<\/span>(data, actions<\/span>) <\/span>{\n    window<\/span>.location.href = '\/paypal\/success?paymentId='<\/span>+data.paymentID+'&PayerID='<\/span>+data.payerID;\n  }\n}).render('#paypal-button-container'<\/span>);\n<\/span><\/script<\/span>><\/span>\n@endsection<\/code><\/span>Code language:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
This example renders PayPal\u2019s official button on your page. Clicking it starts the checkout, and PayPal handles authentication and redirects. Always test in sandbox before going live.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Wrapping Up<\/h2>\n\n\n\n
You\u2019ve successfully integrated PayPal into Laravel. You installed the SDK, configured credentials, built a service for clean code, handled checkout, and tested payments with a UI button. With this flow, you can accept PayPal transactions securely and expand your app\u2019s payment options.<\/p>\n\n\n\n
<\/div>\n\n\n\n
What\u2019s Next<\/h2>\n\n\n\n