Laravel Tutorials

Values present in .env. Use {{ "{{ PLACEHOLDER " }}}} if missing.

APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:9udJHIhqoyemNXWuHuZbm7KTZL2ntEEROAwJr1GnPcc=
APP_DEBUG=true
APP_URL=http://127.0.0.1:8000

APP_LOCALE=en
APP_FALLBACK_LOCALE=en
APP_FAKER_LOCALE=en_US

APP_MAINTENANCE_DRIVER=file
# APP_MAINTENANCE_STORE=database

PHP_CLI_SERVER_WORKERS=4

BCRYPT_ROUNDS=12
...
APP_URL=http://127.0.0.1:8000

# eSewa — Sandbox (UAT)
ESEWA_MERCHANT=EPAYTEST
ESEWA_SECRET=8gBm/:&EnhH.1/q

# v2 form submit (sandbox)
ESEWA_FORM_BASE=https://rc-epay.esewa.com.np
ESEWA_FORM_PATH=/api/epay/main/v2/form

# Status Check (sandbox)
ESEWA_STATUS_BASE=https://rc.esewa.com.np
ESEWA_STATUS_PATH=/api/epay/transaction/status

# Khalti
KHALTI_BASE={{ KHALTI_BASE }}
KHALTI_SECRET_KEY={{ KHALTI_SECRET_KEY }}

Add this block inside return [ ... ]; (if not present):

'khalti' => [
  'base'       => env('KHALTI_BASE', 'https://a.khalti.com'),
  'secret_key' => env('KHALTI_SECRET_KEY'),
],

<?php

// routes/web.php
use App\Http\Controllers\EsewaController;
use App\Http\Controllers\KhaltiController;
use App\Http\Controllers\ShopController;

Route::get('/', fn() => redirect()->route('items.index'));

Route::get('/items', [ShopController::class, 'index'])->name('items.index');
Route::get('/checkout/{item}', [ShopController::class, 'checkout'])->name('checkout.show');

// eSewa
Route::post('/pay/{item}', [EsewaController::class, 'initiate'])->name('esewa.pay');
Route::match(['GET','POST'], '/esewa/success', [EsewaController::class, 'success'])->name('esewa.success');
Route::match(['GET','POST'], '/esewa/failure', [EsewaController::class, 'failure'])->name('esewa.failure');

// Khalti
Route::post('/khalti/initiate/{item}', [KhaltiController::class, 'initiate'])->name('khalti.initiate');
Route::get('/khalti/verify', [KhaltiController::class, 'verify'])->name('khalti.verify');

// List payments
Route::get('/payments', [ShopController::class, 'payments'])->name('payments.index');

<?php

// app/Http/Controllers/EsewaController.php
namespace App\Http\Controllers;

use App\Models\Item;
use App\Models\Payment;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Str;

class EsewaController extends Controller
{
    /** Build the v2 form payload with signature and auto-post to eSewa */
    public function initiate(Request $request, Item $item)
    {
        // ... your existing initiate logic here (project's real code)
    }

    public function success(Request $request)
    {
        // ... your existing success callback verification logic
    }

    public function failure(Request $request)
    {
        $uuid = $request->input('transaction_uuid')
            ?? $request->query('transaction_uuid')
            ?? $request->query('oid')
            ?? $request->query('pid');

        if ($uuid) Payment::where('pid', $uuid)->update(['status'=>'failed']);
        return redirect()->route('payments.index')->with('fail','Payment cancelled or failed.');
    }
}

<?php

namespace App\Http\Controllers;

use App\Models\Item;
use App\Models\Payment;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Str;

class KhaltiController extends Controller
{
    /** Start a Khalti payment (Initiate) and redirect user to hosted page */
    public function initiate(Request $request, Item $item)
    {
        // ... your existing initiate logic here (project's real code)
    }

    /** Verify/lookup result by pidx and update local payment status */
    public function verify(Request $request)
    {
        // ... your existing verify/lookup logic here
    }

    /** Normalize Khalti statuses to our table’s: success | pending | failed */
    private function mapKhaltiStatusToLocal(?string $khaltiStatus): string
    {
        $k = strtolower($khaltiStatus ?? '');
        return match ($k) {
            'completed'              => 'success',
            'initiated', 'pending'   => 'pending',
            'expired', 'user canceled', 'refunded', 'partially_refunded', 'failed' => 'failed',
            default                  => 'pending',
        };
    }
}

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Item extends Model
{
    protected $fillable = ['name','price'];
}

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Payment extends Model
{
    protected $fillable = [
        'item_id','payer_name','payer_email','amount','pid','ref_id','status','meta'
    ];
    protected $casts = ['meta' => 'array'];

    public function item() { return $this->belongsTo(Item::class); }
}

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(): void
    {
        Schema::create('items', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->unsignedInteger('price'); // in NPR
            $table->timestamps();
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('items');
    }
};

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(): void
    {
        Schema::create('payments', function (Blueprint $table) {
            $table->id();
            $table->foreignId('item_id')->constrained()->cascadeOnDelete();
            $table->string('payer_name')->nullable();
            $table->string('payer_email')->nullable();
            $table->unsignedInteger('amount');
            $table->string('pid')->unique();
            $table->string('ref_id')->nullable();
            $table->enum('status',['pending','success','failed'])->default('pending');
            $table->json('meta')->nullable();
            $table->timestamps();
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('payments');
    }
};

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
    <title>{{ config('app.name','Laravel') }}</title>
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet">
  </head>
  <body>
    <nav class="navbar navbar-expand-lg bg-body-tertiary mb-3">
      <div class="container">
        <a class="navbar-brand" href="{{ route('items.index') }}">Shop</a>
        <div class="ms-auto">
          <a class="btn btn-outline-secondary btn-sm" href="{{ route('payments.index') }}">Payments</a>
        </div>
      </div>
    </nav>
    <main>
      @yield('content')
    </main>
    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script>
  </body>
</html>

@extends('layouts.app')

@section('content')
<div class="container py-4">
  <h1 class="mb-3">Items</h1>
  <div class="row g-3">
    @foreach($items as $item)
      <div class="col-md-4">
        <div class="card h-100">
          <div class="card-body">
            <h5 class="card-title mb-1">{{ $item->name }}</h5>
            <p class="text-secondary mb-3">NPR {{ number_format($item->price) }}</p>
            <a href="{{ route('checkout.show',$item) }}" class="btn btn-primary btn-sm">Buy</a>
          </div>
        </div>
      </div>
    @endforeach
  </div>
</div>
@endsection

@extends('layouts.app')

@section('content')
<div class="container py-4">
  <h1 class="mb-3">Checkout</h1>

  <div class="card">
    <div class="card-body">
      <h5 class="mb-1">{{ $item->name }}</h5>
      <p class="mb-3">Amount: NPR {{ number_format($item->price) }}</p>

      <form method="POST" action="{{ route('esewa.pay', $item) }}">
        @csrf
        <div class="row g-3">
          <div class="col-md-6">
            <label class="form-label">Your Name (optional)</label>
            <input type="text" name="payer_name" class="form-control" value="{{ old('payer_name') }}">
          </div>
          <div class="col-md-6">
            <label class="form-label">Email (optional)</label>
            <input type="email" name="email" class="form-control" value="{{ old('email') }}">
          </div>
        </div>

        <div class="mt-3 d-flex gap-2">
          <button type="submit" class="btn btn-success">Pay via eSewa</button>
          <a href="{{ route('items.index') }}" class="btn btn-link">Back</a>
        </div>
      </form>
    </div>
  </div>
</div>
@endsection

<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Redirecting…</title></head>
<body onload="document.forms[0].submit();" style="font-family:system-ui;padding:2rem;">
  <p>Redirecting to eSewa…</p>
  <form method="POST" action="{{ $endpoint }}">
    @csrf
    @foreach($payload as $k => $v)
      <input type="hidden" name="{{ $k }}" value="{{ $v }}">
    @endforeach
    <noscript><button type="submit">Continue to eSewa</button></noscript>
  </form>
</body>
</html>

@extends('layouts.app')

@section('content')
<div class="container py-4">
  <h1 class="mb-3">Payments</h1>
  <div class="table-responsive">
    <table class="table table-striped align-middle">
      <thead>
        <tr>
          <th>#</th>
          <th>Item</th>
          <th>PID</th>
          <th>Ref ID</th>
          <th>Amount</th>
          <th>Status</th>
          <th>Created</th>
        </tr>
      </thead>
      <tbody>
        @foreach($payments as $p)
          <tr>
            <td>{{ $p->id }}</td>
            <td>{{ $p->item->name ?? '-' }}</td>
            <td>{{ $p->pid }}</td>
            <td>{{ $p->ref_id ?? '-' }}</td>
            <td>NPR {{ number_format($p->amount) }}</td>
            <td><span class="badge bg-{{ $p->status === 'success' ? 'success' : ($p->status === 'failed' ? 'danger' : 'warning text-dark') }}">{{ $p->status }}</span></td>
            <td>{{ $p->created_at->format('Y-m-d H:i') }}</td>
          </tr>
        @endforeach
      </tbody>
    </table>
  </div>
</div>
@endsection