I’ll give you a full working Paytm Payment Gateway integration example in Laravel ā step-by-step, including payment page, initiate payment, callback handling, and success/failure handling.
š Full Working Example ā Paytm Integration in Laravel (Latest)
1. Install Laravel Paytm Package
First, install a Paytm SDK/library.
I recommend using "anandsiddharth/laravel-paytm-wallet" (easy and popular):
composer require anandsiddharth/laravel-paytm-wallet
Code language: JavaScript (javascript)2. Configure Paytm Keys in .env
Add your Paytm credentials in your .env file:
PAYTM_MERCHANT_ID=YourMerchantID
PAYTM_MERCHANT_KEY=YourMerchantKey
PAYTM_ENVIRONMENT=local # use 'production' for live
PAYTM_MERCHANT_WEBSITE=WEBSTAGING
PAYTM_CHANNEL=WEB
PAYTM_INDUSTRY_TYPE=Retail
Code language: PHP (php)3. Create Paytm Configuration File
Publish the config if needed:
php artisan vendor:publish --provider="Anand\LaravelPaytmWallet\PaytmWalletServiceProvider"
Code language: JavaScript (javascript)It will create a config/paytm-wallet.php file.
Check it and ensure environment variables are correctly mapped.
4. Create Paytm Controller
Now, create a controller to handle payment:
php artisan make:controller PaytmPaymentController
Code language: CSS (css)Now edit app/Http/Controllers/PaytmPaymentController.php:
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Anand\LaravelPaytmWallet\Facades\PaytmWallet;
class PaytmPaymentController extends Controller
{
public function initiatePayment()
{
return view('paytm-payment');
}
public function pay(Request $request)
{
$payment = PaytmWallet::with('receive');
$payment->prepare([
'order' => 'ORDER_' . uniqid(),
'user' => auth()->id() ?? 1, // or your user id
'mobile_number' => '7777777777', // dummy or real
'email' => 'test@example.com', // dummy or real
'amount' => $request->amount, // dynamic
'callback_url' => route('paytm.callback')
]);
return $payment->receive(); // Redirect to Paytm payment page
}
public function callback()
{
$transaction = PaytmWallet::with('receive');
$response = $transaction->response(); // Response from Paytm
if ($transaction->isSuccessful()) {
// Payment Successful
return redirect()->route('payment.success')->with('message', 'Payment Successful');
} elseif ($transaction->isFailed()) {
// Payment Failed
return redirect()->route('payment.failed')->with('message', 'Payment Failed');
}
}
public function success()
{
return view('payment-success');
}
public function failed()
{
return view('payment-failed');
}
}
Code language: HTML, XML (xml)5. Create Routes in web.php
Add these routes:
use App\Http\Controllers\PaytmPaymentController;
Route::get('/paytm-payment', [PaytmPaymentController::class, 'initiatePayment'])->name('paytm.initiate');
Route::post('/paytm-payment', [PaytmPaymentController::class, 'pay'])->name('paytm.pay');
Route::post('/paytm-callback', [PaytmPaymentController::class, 'callback'])->name('paytm.callback');
Route::get('/payment-success', [PaytmPaymentController::class, 'success'])->name('payment.success');
Route::get('/payment-failed', [PaytmPaymentController::class, 'failed'])->name('payment.failed');
Code language: PHP (php)6. Exclude Callback from CSRF (Important!)
In app/Http/Middleware/VerifyCsrfToken.php, add:
protected $except = [
'/paytm-callback',
];
Code language: PHP (php)ā This fixes the 419 error you were facing.
7. Create Blade View for Payment Page
Create a blade file: resources/views/paytm-payment.blade.php
<!DOCTYPE html>
<html>
<head>
<title>Paytm Payment Gateway</title>
</head>
<body>
<h2>Paytm Payment</h2>
<form method="POST" action="{{ route('paytm.pay') }}">
@csrf
<label>Amount:</label>
<input type="text" name="amount" value="100" required>
<br><br>
<button type="submit">Pay Now</button>
</form>
</body>
</html>
Code language: HTML, XML (xml)8. Create Success and Failure Pages
resources/views/payment-success.blade.php
<h1>Payment Successful!</h1>
<p>{{ session('message') }}</p>
Code language: HTML, XML (xml)resources/views/payment-failed.blade.php
<h1>Payment Failed!</h1>
<p>{{ session('message') }}</p>
Code language: HTML, XML (xml)š Full Flow
| Step | Description |
|---|---|
/paytm-payment | User visits payment page and enters amount. |
/paytm-payment (POST) | User submits, redirected to Paytm payment page. |
| Paytm Payment Page | User makes payment (success/failure). |
/paytm-callback (POST) | Paytm server sends callback after payment. |
| Success or Failure page | User redirected accordingly. |
šÆ Summary
| Item | Status |
|---|---|
Paytm credentials loaded from .env ā
| |
| Laravel Paytm package installed ā | |
| CSRF excluded for callback ā | |
| Payment form, controller, routes done ā | |
| User sees success/failure after payment ā |
š Bonus Tips
- Always log the Paytm callback response for debugging.
- Validate Paytm signature (
CHECKSUMHASH) if needed (package does internally). - Use unique order IDs every time.
- Move Paytm keys into a secure vault if in production.
šÆ Quick Commands for Copying
composer require anandsiddharth/laravel-paytm-wallet
php artisan make:controller PaytmPaymentController
Code language: JavaScript (javascript)
Iām a DevOps/SRE/DevSecOps/Cloud Expert passionate about sharing knowledge and experiences. I have worked at Cotocus. I share tech blog at DevOps School, travel stories at Holiday Landmark, stock market tips at Stocks Mantra, health and fitness guidance at My Medic Plus, product reviews at TrueReviewNow , and SEO strategies at Wizbrand.
Do you want to learn Quantum Computing?
Please find my social handles as below;
Rajesh Kumar Personal Website
Rajesh Kumar at YOUTUBE
Rajesh Kumar at INSTAGRAM
Rajesh Kumar at X
Rajesh Kumar at FACEBOOK
Rajesh Kumar at LINKEDIN
Rajesh Kumar at WIZBRAND
