darkghosthunter / transbanker
用于Laravel的Transbank API连接器
Requires
- php: ^7.3||^7.4||^8.0
- darkghosthunter/transbank-api: ^2.0
- illuminate/config: ^6.0||^7.0||^8.0
- illuminate/events: ^6.0||^7.0||^8.0
- illuminate/http: ^6.0||^7.0||^8.0
- illuminate/support: ^6.0||^7.0||^8.0
- illuminate/view: ^6.0||^7.0||^8.0
Requires (Dev)
- mockery/mockery: ^1.4
- orchestra/testbench: ^4.8||^5.2||^6.0
- phpunit/phpunit: ^9.0
README
此包已被弃用,新版本使用REST和HTTP客户端。
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许可协议授权。
Redcompra
、Webpay
、Onepay
、Patpass
和tbk
是Transbank S.A.的商标。
本软件包不是由Transbank S.A.开发、批准、支持或认可的,也不是由与Transbank S.A.直接或间接关联的自然人或公司开发、批准、支持或认可的。