Laravel Cashier与Razorpay：理解其局限性及独立集成指南-php教程-PHP中文网

Laravel Cashier与Razorpay：理解其局限性及独立集成指南

本文旨在阐明Laravel Cashier对支付网关的支持范围，明确指出其原生支持Stripe和Paddle，而不包括Razorpay。对于希望在Laravel应用中集成Razorpay的用户，本文将提供一套独立的集成策略，包括SDK安装、配置凭证以及核心支付流程的实现步骤，帮助开发者在不依赖Cashier的情况下成功部署Razorpay支付功能，并强调了手动管理订阅及相关业务逻辑的重要性。

1. Laravel Cashier的支付网关支持范围

laravel cashier是一个功能强大的订阅计费管理库，它旨在简化与支付网关的交互，特别是在处理周期性订阅和一次性支付方面。然而，cashier的设计初衷是为了与特定的支付服务提供商深度集成，以提供高度抽象和统一的api接口。

目前，Laravel Cashier原生且仅支持以下两个支付网关：

Stripe: 广泛应用于全球的支付处理平台，提供强大的API和丰富的计费功能。
Paddle: 专注于SaaS产品的支付、订阅和税收管理平台，尤其适合软件销售。

这意味着，如果您正在使用Laravel Cashier，并且希望利用其提供的订阅管理、发票生成、退款处理等高级功能，您只能选择Stripe或Paddle作为您的支付服务提供商。Cashier通过封装这些特定网关的API，为开发者提供了一致且简化的接口，从而大大降低了实现订阅计费系统的复杂性。

明确指出，Laravel Cashier目前不直接支持Razorpay。Razorpay是一个在印度市场非常流行的支付网关，但它没有被集成到Laravel Cashier的核心功能中。因此，如果您计划在您的Laravel应用中使用Razorpay，您将无法通过Cashier来管理其支付流程，需要采用独立的集成方案。

2. Razorpay的独立集成策略

尽管Laravel Cashier不直接支持Razorpay，但您仍然可以在Laravel应用中成功集成Razorpay。这需要您直接与Razorpay的API进行交互，并自行管理支付流程的各个环节。以下是实现这一目标的详细步骤和示例。

2.1 安装Razorpay PHP SDK

首先，您需要通过Composer安装Razorpay官方提供的PHP SDK。这个SDK封装了Razorpay的API，使您能够方便地与支付网关进行通信。

composer require razorpay/razorpay

登录后复制

2.2 配置Razorpay API凭证

安装SDK后，您需要配置您的Razorpay API密钥ID和密钥秘钥。这些凭证通常可以在您的Razorpay商家账户仪表板中获取。建议将它们存储在Laravel的.env文件中，并通过config/services.php进行访问，以确保安全性。

在.env文件中添加：

RAZORPAY_KEY_ID=rzp_test_xxxxxxxxxxxxxxxxxx
RAZORPAY_KEY_SECRET=xxxxxxxxxxxxxxxxxxxxxx

登录后复制

在config/services.php中添加或修改：

'razorpay' => [
    'key_id' => env('RAZORPAY_KEY_ID'),
    'key_secret' => env('RAZORPAY_KEY_SECRET'),
],

登录后复制

2.3 实现核心支付流程

Razorpay的支付流程通常包括以下几个关键步骤：在后端创建订单、在前端展示支付界面、处理支付回调以及验证支付签名。

集简云

软件集成平台，快速建立企业自动化与智能化

查看详情

2.3.1 创建订单 (后端)

当用户发起支付请求时，您需要在后端使用Razorpay SDK创建一个订单。这个订单将包含支付金额、货币类型和可选的收据ID等信息。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Razorpay\Api\Api;

class RazorpayController extends Controller
{
    public function createOrder(Request $request)
    {
        // 验证请求数据，例如金额、商品信息等
        $amount = 10000; // 金额以“派士”为单位，例如100.00 INR = 10000
        $currency = 'INR'; // 货币代码

        try {
            $api = new Api(config('services.razorpay.key_id'), config('services.razorpay.key_secret'));

            $order = $api->order->create([
                'receipt' => 'order_rcptid_' . uniqid(), // 唯一的收据ID
                'amount' => $amount,
                'currency' => $currency,
                'payment_capture' => 1 // 自动捕获支付
            ]);

            // 将订单ID存储到数据库，与您的用户或商品关联
            // 例如：Auth::user()->orders()->create(['razorpay_order_id' => $order->id, 'amount' => $amount, 'status' => 'pending']);

            return view('payment.checkout', compact('order', 'amount', 'currency'));

        } catch (\Exception $e) {
            return redirect()->back()->with('error', '创建支付订单失败: ' . $e->getMessage());
        }
    }
}

登录后复制

2.3.2 前端支付页面

在后端创建订单后，您需要将订单信息传递到前端页面，并使用Razorpay Checkout JS SDK来渲染支付界面。用户将在该界面完成支付。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Razorpay 支付</title>
</head>
<body>
    <h1>请完成支付</h1>

    <form action="{{ route('razorpay.callback') }}" method="POST">
        @csrf
        <script
            src="https://checkout.razorpay.com/v1/checkout.js"
            data-key="{{ config('services.razorpay.key_id') }}"
            data-amount="{{ $order->amount }}"
            data-currency="{{ $order->currency }}"
            data-order_id="{{ $order->id }}"
            data-buttontext="立即支付"
            data-name="您的公司名称"
            data-description="订单描述"
            data-image="https://your-logo-url.png"
            data-prefill.name="用户姓名"
            data-prefill.email="user@example.com"
            data-theme.color="#F37254"
        ></script>
        <input type="hidden" custom="Hidden Element" name="hidden">
    </form>

    <p>总金额: {{ number_format($amount / 100, 2) }} {{ $currency }}</p>
</body>
</html>

登录后复制

请确保将data-name、data-description和data-image替换为您的实际信息。

2.3.3 处理支付回调 (后端)

当用户完成支付后，Razorpay会将支付结果（包括支付ID和签名）回传到您指定的路由。您需要在后端处理这个回调，并验证支付签名的合法性，以确保支付的真实性。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Razorpay\Api\Api;
use Razorpay\Api\Errors\SignatureVerificationError;

class RazorpayController extends Controller
{
    public function handleCallback(Request $request)
    {
        $input = $request->all();

        try {
            $api = new Api(config('services.razorpay.key_id'), config('services.razorpay.key_secret'));

            $attributes = [
                'razorpay_order_id' => $input['razorpay_order_id'],
                'razorpay_payment_id' => $input['razorpay_payment_id'],
                'razorpay_signature' => $input['razorpay_signature']
            ];

            $api->utility->verifyPaymentSignature($attributes);

            // 签名验证成功，支付有效
            // 在这里更新您的数据库中的订单状态，标记为“已支付”
            // 例如：Order::where('razorpay_order_id', $input['razorpay_order_id'])->update(['status' => 'completed', 'razorpay_payment_id' => $input['razorpay_payment_id']]);

            // 可以获取支付详情
            // $payment = $api->payment->fetch($input['razorpay_payment_id']);

            return redirect()->route('payment.success')->with('success', '支付成功！');

        } catch (SignatureVerificationError $e) {
            // 签名验证失败，支付可能被篡改或无效
            // 记录错误信息，通知用户支付失败
            return redirect()->route('payment.failure')->with('error', '支付失败或签名验证失败：' . $e->getMessage());
        } catch (\Exception $e) {
            // 其他异常处理
            return redirect()->route('payment.failure')->with('error', '支付处理异常：' . $e->getMessage());
        }
    }

    public function paymentSuccess()
    {
        return view('payment.success');
    }

    public function paymentFailure()
    {
        return view('payment.failure');
    }
}

登录后复制

2.3.4 定义路由

为了使上述控制器方法可访问，您需要在routes/web.php中定义相应的路由：

use App\Http\Controllers\RazorpayController;

Route::get('/pay', [RazorpayController::class, 'createOrder'])->name('razorpay.pay');
Route::post('/razorpay/callback', [RazorpayController::class, 'handleCallback'])->name('razorpay.callback');
Route::get('/payment/success', [RazorpayController::class, 'paymentSuccess'])->name('payment.success');
Route::get('/payment/failure', [RazorpayController::class, 'paymentFailure'])->name('payment.failure');

登录后复制

3. 注意事项与最佳实践

在独立集成Razorpay时，有几个关键点需要特别注意：

安全性： 始终保护您的Razorpay API密钥，不要将其直接暴露在前端代码中。支付回调的签名验证是确保交易真实性和防止篡改的关键步骤，务必严格执行。
订阅与周期计费： 如果您的应用是SaaS模式并需要订阅功能，您将需要自行实现订阅管理逻辑。这包括：
- 订阅创建： 记录用户的订阅计划、开始日期和结束日期。
- 周期扣款： 定期通过Razorpay API发起新的支付请求（或使用Razorpay的订阅功能，这与Cashier的抽象不同）。
- 续订/取消： 提供用户续订或取消订阅的界面和后端逻辑。
- Webhook： 考虑使用Razorpay的Webhook来接收异步事件通知（如支付成功、失败、退款等），以便您的系统能及时更新订单状态。
错误处理与用户反馈： 提供清晰的用户界面和友好的错误消息，指导用户在支付失败时如何操作。记录所有支付相关的日志，以便于调试和审计。
测试环境： 在将应用部署到生产环境之前，务必在Razorpay的沙箱（测试）环境中进行充分的端到端测试，确保所有支付流程都按预期工作。
退款与取消： 如果需要支持退款功能，您需要通过Razorpay SDK调用相应的API来处理退款请求。

总结

Laravel Cashier为Stripe和Paddle提供了强大的订阅计费抽象，极大地简化了相关开发工作。然而，对于Razorpay等未被Cashier原生支持的支付网关，开发者需要采取独立的集成策略。这意味着您需要直接使用Razorpay的PHP SDK来管理订单创建、支付流程和回调验证。虽然这会增加一定的开发工作量，尤其是在需要实现订阅管理时，但它提供了更大的灵活性和对支付流程的完全控制。通过遵循本文提供的指南和最佳实践，您可以成功地在Laravel应用中集成Razorpay，并构建稳定可靠的支付系统。

以上就是Laravel Cashier与Razorpay：理解其局限性及独立集成指南的详细内容，更多请关注php中文网其它相关文章！