🔥 Conclusion (Real World):

✅ Full Tutorial: Paytm Subscription & Recurring Payments (Laravel)

Step 1: Install Paytm Official Packages

composer require paytm/paytm-pg
composer require paytm/paytmchecksum

✅ This will install the latest versions.

Step 2: Set Paytm Credentials in .env

PAYTM_ENVIRONMENT=PROD
PAYTM_MERCHANT_ID=YOUR_MERCHANT_ID
PAYTM_MERCHANT_KEY=YOUR_MERCHANT_KEY
PAYTM_WEBSITE=YOUR_WEBSITE_NAME
PAYTM_CALLBACK_URL=https://yourdomain.com/paytm/subscription/callback

✅ (Get all these from your Paytm Dashboard)

Step 3: Create Subscription Request API (Laravel Controller)

Create SubscriptionController.php:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Paytm\pg\MerchantProperty;
use Paytm\pg\RefundApi;
use Paytm\pg\SubscriptionApi;
use Paytm\pg\TransactionApi;
use Paytm\pg\utility\Config;
use Paytm\pg\utility\PaytmHelper;
use PaytmChecksum;

class SubscriptionController extends Controller
{
    public function createSubscription(Request $request)
    {
        // Step 1: Set Paytm environment properties
        MerchantProperty::setMerchantId(env('PAYTM_MERCHANT_ID'));
        MerchantProperty::setMerchantKey(env('PAYTM_MERCHANT_KEY'));
        MerchantProperty::setMerchantWebsite(env('PAYTM_WEBSITE'));
        MerchantProperty::setIndustryTypeId('Retail');
        MerchantProperty::setChannelId('WEB');

        // Step 2: Prepare subscription body
        $body = [
            "requestType"   => "NATIVE_SUBSCRIPTION",
            "mid"           => env('PAYTM_MERCHANT_ID'),
            "websiteName"   => env('PAYTM_WEBSITE'),
            "subscriptionRequest" => [
                "subscriptionAmountType" => "FIX",
                "subscriptionAmount" => "100.00",
                "subscriptionFrequency" => "MONTHLY",
                "subscriptionFrequencyUnit" => "MONTH",
                "subscriptionStartDate" => now()->addMinutes(5)->format('Y-m-d'), // Start after 5 mins
                "subscriptionGraceDays" => 3,
                "subscriptionExpiryDate" => now()->addYear(1)->format('Y-m-d'),
                "paymentInstrument" => [
                    "paymentMode" => "CARD",
                ],
                "payerInfo" => [
                    "name" => "John Doe",
                    "email" => "john@example.com",
                    "mobile" => "7777777777",
                ],
            ]
        ];

        // Step 3: Generate Checksum
        $checksum = PaytmChecksum::generateSignature(json_encode($body), env('PAYTM_MERCHANT_KEY'));

        // Step 4: Prepare final request
        $header = [
            "signature" => $checksum
        ];

        $paytmParams = [
            "head" => $header,
            "body" => $body
        ];

        // Step 5: Send the Subscription Request
        $url = "https://securegw.paytm.in/subscription/create";

        $response = $this->callNewApi($url, $paytmParams);

        return response()->json(json_decode($response, true));
    }

    private function callNewApi($url, $params)
    {
        $data_string = json_encode($params);

        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); 
        curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string); 
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); 
        curl_setopt($ch, CURLOPT_HTTPHEADER, [ 
            'Content-Type: application/json',
            'Content-Length: ' . strlen($data_string)
        ]);

        $response = curl_exec($ch);

        return $response;
    }
}

Step 4: Setup Route in web.php

use App\Http\Controllers\SubscriptionController;

Route::post('/paytm/subscription', [SubscriptionController::class, 'createSubscription']);

Step 5: Handle Callback/Webhook after Subscription

Create another function:

public function subscriptionCallback(Request $request)
{
    // Paytm will POST data here
    $payload = $request->all();

    // Validate signature
    $isValidChecksum = PaytmChecksum::verifySignature(
        json_encode($payload['body']), 
        env('PAYTM_MERCHANT_KEY'), 
        $payload['head']['signature']
    );

    if ($isValidChecksum) {
        // Update your database subscription status
        return response('Callback handled successfully.', 200);
    } else {
        return response('Invalid checksum', 400);
    }
}

Your Flow Will Be:

1. Frontend → Call /paytm/subscription → Start Subscription
2. Paytm → Redirect/Callback → /paytm/subscription/callback
3. Laravel backend → Capture and validate → Update Subscription table.

Tip:

Paytm also provides Webhook URLs (for subscription renewal, payment failures, etc.).
✅ Make sure to listen to webhook events and handle renewals or failures properly in production!

✅ Final Recommendation: