maree / alrajhibank-payments
用于与沙特阿拉伯拉杰希银行支付API集成的包 باكدج للربط مع خدمات الدفع الالكتروني مع بنك الرجحي السعودي
dev-main
2022-04-20 22:56 UTC
This package is auto-updated.
Last update: 2024-09-21 03:47:13 UTC
README
安装
您可以通过Composer安装此包。
composer require maree/alrajhibank-payments
使用以下命令发布您的alrajhibank配置文件
php artisan vendor:publish --provider="maree\alrajhibankPayments\AlrajhibankServiceProvider" --tag="alrajhiBank"
然后更改config/alrajhiBank.php文件中的AlrajhiBank配置
"id" => "" , "password" => "" , "currencyCode" => "682",//SAR => 682 "encryption_key" => "",
用法
第一步
use maree\alrajhibankPayments\AlrajhiBank; $response = AlrajhiBank::checkout($amount = 0.0,$responseURL='',$errorURL='');
注意
- 此函数返回 ['key' => 'success' ,'checkoutId' => $payment_id , 'responseData' => $responseData] //key = success or fail
- 使用checkoutId将交易保存到数据库
- 在下一步中,在视图页面上使用checkoutId
第二步
- 返回包含$checkoutId的视图页以显示支付流程
<iframe src="{{config('alrajhiBank.view_url').$checkoutId}}" style="width: 100%; height: 100%" title="description"></iframe>
注意
- 为响应URL创建路由 'show-response-route',例如:Route::get('show-response-route', 'PaymentsController@paymentresponse')>name('show-response-route');
- 为错误响应URL创建路由 'show-response-error',例如:Route::get('show-response-error', 'PaymentsController@paymentresponseError')>name('show-response-error');
- 创建检查响应的函数 'paymentresponse' 和错误 'paymentresponseError'
- 使用该函数检查支付是否失败或成功
在'paymentresponse'和'paymentresponseError'函数内部使用
use maree\alrajhibankPayments\AlrajhiBank; //trandata = $request->trandata $response = AlrajhiBank::checkoutResponseStatus($trandata);
返回如下响应
['key' => 'success' , 'responseData' => $responseData];
或
['key' => 'fail', 'responseData' => $responseData];
注意:您可以使用响应数据将交易保存到数据库