zerkxubas/esewa-laravel

此包使Esewa支付网关的集成更加容易。

v1.1.0 2024-02-17 17:09 UTC

This package is auto-updated.

Last update: 2024-09-17 18:52:59 UTC


README

此包是为Laravel框架设计的,使开发者能够轻松地将eSewa支付集成到Laravel应用程序中,并立即使用。有关更多详细信息,请阅读官方eSewa文档。

安装

安装此包 – 使用 Composer

Composer安装

composer require zerkxubas/esewa-laravel

Sail安装

sail composer require zerkxubas/esewa-laravel

发布配置

php artisan vendor:publish --tag=esewa

这将发布 esewa.php 到您的Laravel项目配置目录中。

.env设置 [ 开发模式 ]

.env 文件中使用以下配置值进行快速设置。对于 生产模式,请确保您设置了 ESEWA_DEBUG_MODE=false,并使用生产 ESEWA_API_URL 以及在 .env 文件中的 ESEWA_MERCHAND_CODE

ESEWA_API_URL=https://uat.esewa.com.np
ESEWA_DEBUG_MODE=true
ESEWA_MERCHANT_CODE=EPAYTEST
ESEWA_SUCCESS_URL="https:///order/success"
ESEWA_FAILURE_URL="https:///payment/failure"

注意: 我更喜欢使用Sail环境进行开发,所以在这里的 .env 文件中URL看起来没有端口,但您可以使用对您有效的任何URL。

快速示例

轻松创建eSewa门户支付结账

在此方法中,我已经使实现和即时使用变得超级简单和容易。在您的控制器中使用以下示例代码,这将用户带到eSewa支付门户。

// use the namespace
use Zerkxubas\EsewaLaravel\Facades\Esewa;

// Directly use like this inside the controller function code.
return Esewa::checkout($paymentID,$totalAmount,$taxAmount,$serviceCharge,$deliveryCharge);

不要忘记创建成功和失败的路由

参数

  1. pid => paymentID
  2. amt => totalAmount
  3. txAmt => taxAmount
  4. psc => serviceCharge
  5. pdc => deliveryCharge

测试凭据

为测试或开发目的提供的eSewa默认凭据。

eSewa ID: 9806800001/2/3/4/5

密码: Nepal@123

令牌: 123456

验证支付

为了验证我们的支付状态,这个操作超级简单和容易,只需像这样使用即可。

// use the namespace
use Zerkxubas\EsewaLaravel\Facades\Esewa;

// Taking the get request return parameters.
$paymentID = $_GET['oid'];
$transactionAmount = $_GET['amt'];
$refrenceID = $_GET['refId'] ;

// Verifying the Esewa Payment, [ returns, Either true or false ]
$paymentStatus = Esewa::verifyPayment($refrenceID,$paymentID,$transactionAmount);

if ($paymentStatus) {
    // Success payment.
}

许可证

此包是开源的,并且免费使用,根据 MIT许可证 授权。

附加

强烈建议阅读eSewa官方文档,因为将来可能会有新变化,这对于开发者来说至关重要,需要了解最新的变化。