biscolab/laravel-gestpay

此包已被废弃,不再维护。未建议替代包。

v1.2.1 2018-07-20 15:25 UTC

This package is auto-updated.

Last update: 2020-03-27 14:03:23 UTC


README

Packagist version Build Status

Gestpay - Banca Sella为Laravel 5提供的支付库。让您的客户通过Gestpay - Banca Sella在您的网站上轻松使用信用卡进行购买 文档将在未来几天内进行改进

责任限制

MIT License

我们不负责由这些文件引起的任何错误或问题。 请在使用此包之前仔细阅读Gestpay的官方文档

安装

您可以通过composer安装此包

composer require biscolab/laravel-gestpay

服务提供者必须在config/app.php中注册

'providers' => [
    ...
    Biscolab\Gestpay\GestpayServiceProvider::class,
];

您可以使用外观来缩短代码。将 "Gestpay" 添加到您的别名中

'aliases' => [
    ...
    'Gestpay' => Biscolab\Gestpay\Facades\Gestpay::class,
];

使用以下命令创建config/gestpay.php配置文件

php artisan vendor:publish --provider="Biscolab\Gestpay\GestpayServiceProvider"

配置

Laravel配置

打开config/gestpay.php配置文件,并设置shopLoginuicCode

return [
    'shopLogin'      => 'YOUR_SHOP_LOGIN',
    'uicCode'        => 'CURRENCY_CODE',
    'test'           => true // supported: true|false 
];
  • shopLogin是分配给您的账户的代码
  • uicCode已设置为242(欧元)。您可以在此处找到货币代码的完整列表
  • 测试如果为true,表示您正在使用您的测试账户。更多信息请参阅使用Gestpay支付页面

有关shopLoginuicCode的更多信息,请访问Gestpay - 创建您的自定义支付页面

Gestpay配置

登录到您的 Gestpay BackOffice 账户并设置

  • IP地址(您的服务器IP,您可以添加多个)
  • 响应地址
    • 正面响应的URL(例如,https://[yourdomain]/gestpay_callback/ok)
    • 负面响应的URL(例如,https://[yourdomain]/gestpay_callback/ko)

如何使用

好的,现在让我们付款!

一如既往,付款是最简单的事情

gestpay()->pay($amount, $shopTransactionId);

就这些了!

  • $amount: 是您需要支付的金额
  • $shopTransactionId: 是您分配给交易的唯一标识符

我只是在开玩笑,还没完!现在您需要处理回调。根据Gestpay配置,您现在必须创建路由。例如,您可以创建一个控制器,通过"gestpayCallback"方法处理回调

    // e.g.
    Route::get('/gestpay_callback/{status}', ['uses' => 'GestpayController@gestpayCallback']);

现在,检查付款是否成功。Gestpay响应包含2个参数:a和b。 gestpayCallback将是

public function gestpayCallback($status){
    ...
    $gestpay_response = gestpay()->checkResponse();
}

$gestpay_response将是一个GestpayResponse对象。您可以使用以下方法检索$gestpay_response属性

  • $gestpay_response->getTransactionResult()返回transaction_result;应该是true或false
  • $gestpay_response->getShopTransactionId() 返回 shop_transaction_id;通过 pay 方法发送的 $shopTransactionId
  • $gestpay_response->getErrorCode() 返回 error_code;交易成功时设置为 "0"
  • $gestpay_response->getErrorDescription() 返回 error_description;选择的语言中的错误代码文字描述

然后您可以更新您的数据库或您想要的任何内容!