PHPackages qfz9527/saobei-sdk - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. qfz9527/saobei-sdk ActiveLibrary[API Development](/categories/api) qfz9527/saobei-sdk ================== SDK for saobei API 2.1.4(3y ago)016MITPHPPHP >=5.3 Since Oct 20Pushed 2y agoCompare [ Source](https://github.com/qfz9527/saobei-sdk)[ Packagist](https://packagist.org/packages/qfz9527/saobei-sdk)[ RSS](/packages/qfz9527-saobei-sdk/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (8)Used By (0) Saobei php-sdk ============== [](#saobei-php-sdk) 简介 -- [](#简介) 利楚商务 **接口对接** 的PHP版SDK，集成几乎所有现版本开放接口，让开发者专注功能开发，从枯燥而没有规律的参数中解放出来，极简化对接。 安装 -- [](#安装) 最好的安装方法是通过 [Composer](http://getcomposer.org/) 包管理器 : ``` composer require qfz9527/saobei-sdk ``` 依赖 -- [](#依赖) - **PHP 5.3** or later - **libcurl 7.10.5** or later 快速开始 ---- [](#快速开始) #### 样例解析 [](#样例解析) - **支付接口** 用于支付场景，以下将以付款码支付(barcodepay)为例： ``` //实例化调度器 $sdk = new \Saobei\sdk\Dispatcher(); //配置商户号、终端号、终端token $sdk->initTerminal('yourMerchantNo', 'yourTerminalId', 'yourAccessToken'); //传入必传参数 $param = array( 'pay_type' => '010', //支付方式：微信、支付宝等 'terminal_trace' => '12345678901234567890123456789012', //客户端唯一流水号，生成须有识别性 'total_fee' => '1', //支付金额（分） 'auth_no' => '12345678901' //付款码 ); //调用方法，方法名大小写不敏感 //$result = $client->barcodepay($param); $result = $sdk->barcodePay($param); ``` - **异步回调**内置验签，开发者传入闭包进行业务处理，下以交易通知为例： ``` //实例化调度器 $sdk = new \Saobei\sdk\Dispatcher(); //配置商户号、终端号、终端token $sdk->initTerminal('yourMerchantNo', 'yourTerminalId', 'yourAccessToken'); //请求转化为数组 $data = json_decode(file_get_contents('php://input'), true);//php-fpm模式接参 //$data = JsonParser::ToArray($request->post());//Request类接参 //传入闭包，处理业务逻辑 $response = $sdk->notify($data, function() use ($data) { //TODO 业务逻辑 var_dump($data); //if($data['total_fee'] == '1')echo "Amount checked \n"; /** * 闭包返回 * @example * [] * ["status" => true] * ["status" => true, "errmsg" => "成功"] * ["status" => false, "errmsg" => "签名失败"] * */ return array(); }); //额外参数 $response['trace_no'] = $data['trace_no']; //响应 echo json_encode($response, 256); ``` - **商户接口**的配置参数与方法与支付有所不同： ``` //实例化调度器 $sdk = new \Saobei\sdk\Dispatcher(); //配置机构号、KEY $sdk->initMerchant('yourInstNo', 'yourKey'); ``` #### 接口方法列表 [](#接口方法列表) > 方法名大小写不敏感 - barCodePay 付款码支付 - prePay 扫码支付 - jsPay 公众号预支付 - miniPay 小程序支付 - facePay 刷脸支付 - wapPay WAP SDK - qrPay 聚合码支付 - query 支付订单查询 - refund 支付订单退款 - cancel 支付订单取消 - close 支付订单关闭 - faceInfo 刷脸信息 - authCodeToOpenId 授权码查询OPENID - authAccessToken 微信获取access\_token - authOpenId 微信公众号JSAPI支付授权 - scanOrderSync 扫码点餐数据上传 - notify 交易通知 - orderSync 交易实时同步 - fenQiRateQuery 分期费率查询 - fenQiBarCodePay 分期刷卡支付 - fenQiPrePay 分期扫码支付 - fenQiJsPay 分期公众号预支付 - fenQiMiniPay 分期小程序支付 - fenQiQuery 分期查询订单 - fenQiRefund 分期退款 - fenQiCancel 分期取消订单 - fenQiClose 分期关闭订单 - fenQiNotify 分期交易通知 - preAuthBarCodePay 条码预授权 - preAuthQR 获取预授权聚合码 - preAuthQRH5Pay 预授权聚合码 - preAuthJsPay 公众号预授权 - preAuthMiniPay 小程序预授权 - preAuthFacePay 刷脸预授权 - preAuthQuery 预授权查询 - preAuthStatusQuery 预授权查询状态 - preAuthFinish 预授权完成 - preAuthCancel 预授权取消 - partnerPay 交通代扣申请扣款 - partnerQuery 交通代扣查询订单 - partnerRefund 交通代扣退款 - partnerUser 交通代扣查询用户 - merchantAdd 商户新增 - merchantCheckName 商户名查重 - merchantUpdate 商户更新 - merchantAddStore 创建门店 - merchantUpdateStore 修改门店 - merchantquerystore 门店查询 - merchantaddterminal 创建终端 - merchantqueryterminal 查询终端 - billDownLoad 账单下载 - weChatConfigSet 微信配置设置 - weChatConfigGet 微信配置查询 - updatePayRate 修改支付费率 - queryChannelMerchant 查询子商户 - updateBankCardInfo 修改结算卡 - queryBankCardInfo 查询结算卡 - updateSettleType 修改结算周期 - querySettleType 查询结算周期 - opend0 即时到账申请 - queryd0 即时到账查询 - merchantInfoNotify 商户异步通知 - merchantUpdateNotify 商户修改异步通知 - queryCash 查询余额 - queryFee 查询手续费 - applycash 发起提现 - settlementRecords 查询清算 - generateContract 生成电子协议 - signContract 签署电子协议 - queryContract 查询电子协议 - queryAllocate 查询分账 - doAllocate 发起分账 - cancelAllocate 取消分账 - queryAllocateRecord 查询分账记录 - openTransfer 开启转账 - doTransfer 发起转账 - queryTransfer 查询转账 目录结构 ---- [](#目录结构) ``` ├── demos/ ----- 参考样例 ├── src/ │ ├── Config/ ----- 配置门面 │ ├── Exception/ ----- 定义异常类目录 │ ├── Model/ ----- 实体 │ ├── Util/ ----- 工具类 │ └── Dispatcher.php/ ----- 集中调度器 ├── composer.json └── README.md ``` --- - src/Dispatcher.php中集成所有方法，若有疑问可查看相关实体类。 - src/Util/HttpClient.php 为 `curl` 版简单封装的请求类，可以替换为其他客户端。 > HttpClient方法调用封装在Dispatcher.php调度器中，如需替换须按需修改 - 为区别发送请求和接回调，组件分别使用 `request` 类发送请求， `response` 类接收回调。`/src/model` 目录下实体都以此标准区分。 > `request` 类的返回体将直接转换为数组交予开发者，不做其他逻辑处理。 > > `response` 类的请求体将经过状态码判断与验签后交予开发者，开发者使用闭包处理业务逻辑。 --- Email : ** ### Health Score 22 — LowBetter than 22% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community8 Small or concentrated contributor base Maturity46 Maturing project, gaining track record Bus Factor1 Top contributor holds 71.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~8 days Total 7 Last Release 1249d ago Major Versions 1.0.0 → 2.0.02022-10-20 ### Community Maintainers ![](https://www.gravatar.com/avatar/605889c14b71a45f23c0853ddb6cbbb6a24243cfd7d37244ddc3739b738ee7a3?d=identicon)[qfz9527](/maintainers/qfz9527) --- Top Contributors [![qfz9527](https://avatars.githubusercontent.com/u/24431828?v=4)](https://github.com/qfz9527 "qfz9527 (15 commits)")[![dmk629](https://avatars.githubusercontent.com/u/42395897?v=4)](https://github.com/dmk629 "dmk629 (6 commits)") --- Tags phpapisdkpaysaobei ### Embed Badge ![Health badge](/badges/qfz9527-saobei-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/qfz9527-saobei-sdk/health.svg)](https://phpackages.com/packages/qfz9527-saobei-sdk) ``` ### Alternatives [jstolpe/instagram-graph-api-php-sdk Instagram Graph API PHP SDK 13998.4k2](/packages/jstolpe-instagram-graph-api-php-sdk)[clever/clever-php 231.6k](/packages/clever-clever-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)