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];

注意:您可以使用响应数据将交易保存到数据库