darkghosthunter/transbanker

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

用于Laravel的Transbank API连接器

v3.1.0 2021-03-19 17:20 UTC

This package is auto-updated.

Last update: 2021-05-05 04:44:16 UTC


README

此包已被弃用,新版本使用REST和HTTP客户端。

Sharon McCutcheon - Unsplash (UL) #-8a5eJ1-mmQ

Latest Stable Version License Build Status Coverage Status Maintainability Test Coverage

Laravel Transbanker

用于Laravel的Transbank API连接器

此包连接到 Transbank API 包,允许您在Laravel应用程序中使用Transbank支付网关。

要求

  • PHP >= 7.3
  • Laravel 6.x, 7.x 或 8.x

请检查旧版本以获取旧Laravel版本。

安装

调用composer并将其添加到您的应用程序中。

composer require darkghosthunter/transbanker

配置

环境

默认情况下,该包使用 integration,除非您明确设置 production,这将使所有交易都变为真实。

TRANSBANK_ENV=production

凭证

integration 环境中,会自动设置测试凭证,所以除非您想要覆盖它们之一,否则不需要设置。

否则,在 production 环境中,您需要为您的服务添加Transbank凭证。

对于Webpay,这些凭证必须位于 storage/transbank/webpay 目录下作为文件。您可以覆盖此包中包含的默认 webpay.cert 文件。

WEBPAY_COMMERCE_CODE=5000000001
WEBPAY_PRIVATE_KEY=private.key
WEBPAY_PUBLIC_CERT=public.cert
WEBPAY_CERT=webpay.cert

对于Onepay,您可以直接使用API密钥和密钥。

ONEPAY_API_KEY=dKVhq1WGt_XapIYirTXNyUKoWTDFfxaEV63-O5jcsdw
ONEPAY_SECRET="?XW#WOLG##FBAGEAYSNQ5APD#JF@$AYZ"

如果您的密钥中包含 # 字符,您可能需要用双引号 " 包围它。

这就是基本配置。如果您需要对此包进行微调,请参阅高级部分。

重定向

此包注册了 transbank::webpay-redirect,用于即时重定向到Webpay。当创建Webpay Plus或Webpay Oneclick交易时,您可以在控制器中即时重定向用户到支付网关。

<?

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use DarkGhostHunter\Transbanker\Facades\Webpay;

class PaymentController extends Controller {
    
    /**
     * Creates a Payment
     * 
     * @param Request $request
     * @return \Illuminate\View\View
     */
    public function pay(Request $request)
    {
        // .. Validate Request, amount, etc..
        
        $response = Webpay::createNormal([
            'sessionId' => $request->session()->getId(),
            'buyOrder'  => 'myOrder#16548',
            'amount'    => 1000,
        ]);
        
        return view('transbanker::webpay-redirect', [
            'response' => $response            
        ]);
    }
    
}

用法

有关用法,请参阅 TransbankApi(西班牙语,Google翻译的英文版)。

高级

为了微调Transbanker,只需发布配置文件

php artisan vendor:publish --provider="DarkGhostHunter\Transbanker\TransbankerServiceProvider"

这将在 config 目录中发布 transbank.php 文件。

路由

此包带有一些默认路由,适用于您的应用程序(如 config/transbank.php 中配置的那样)

服务 URL
Webpay Plus 返回URL http://yourappurl.com/webpay/result
Webpay Plus 最终URL http://yourappurl.com/webpay/receipt
Webpay Plus 商场返回URL http://yourappurl.com/webpay/mall/result
Webpay Plus 商城最终URL http://yourappurl.com/webpay/mall/receipt
Webpay 一键支付 响应URL http://yourappurl.com/webpay/registration
一卡通支付 回调URL http://yourappurl.com/onepay/result

您可以随意更改这些URL。

无论如何,请确保在这些路由中添加您的逻辑以接收Transbank的HTTP POST请求,并移除csrf中间件,因为Webpay需要访问这些路由以处理支付。

许可

本软件包是开源软件,根据MIT许可协议授权。

RedcompraWebpayOnepayPatpasstbkTransbank S.A.的商标。

本软件包不是由Transbank S.A.开发、批准、支持或认可的,也不是由与Transbank S.A.直接或间接关联的自然人或公司开发、批准、支持或认可的。