zerkxubas / esewa-laravel
此包使Esewa支付网关的集成更加容易。
v1.1.0
2024-02-17 17:09 UTC
Requires
- php: >=8.0
- ext-curl: *
- ext-simplexml: *
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.42
- phpunit/phpunit: ^9.6.15
- rector/rector: ^0.18.13
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);
不要忘记创建成功和失败的路由
参数
pid
=>paymentID
amt
=>totalAmount
txAmt
=>taxAmount
psc
=>serviceCharge
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官方文档,因为将来可能会有新变化,这对于开发者来说至关重要,需要了解最新的变化。