CRMEB 多商户商城系统，B2B2C模式电子商务系统，新增商品套餐功能v1.7.3（0122）（完整包）

<h1 align="center">Payment使用文档</h1> # JetBrains OS licenses `payment` had been being developed with PhpStorm under the free JetBrains Open Source license(s) granted by JetBrains s.r.o., hence I would like to express by thanks here. [](https://www.jetbrains.com/?from=ABC) [![Software license][ico-license]](LICENSE) [![Latest development][ico-version-dev]][link-packagist] [![Monthly installs][ico-downloads-monthly]][link-downloads] 老版本文档：http://helei112g.github.io/payment 新版本文档如下 ## Stargazers over time [![Stargazers over time][starchart-cc]](https://starchart.cc/helei112g/payment) ----- # 联系&打赏 [打赏名单](SUPPORT.md) 请大家使用时根据示例代码来，有bug直接提交 `issue`；**提供付费技术支持**。 <div style="margin:0 auto;"> <p align="center" style="margin:0px;"><img width="60%" src="https://dayutalk.cn/img/pub-qr.jpeg?v=123"></p> <p align="center" style="margin:0px;"><img width="60%" src="https://dayutalk.cn/img/pay-qr.jpeg"></p> </div> # 目录 - [公告](#公告) - [重要通知](#重要通知) - [计划](#计划) - [Payment解决什么问题](#Payment解决什么问题) - [如何使用](#如何使用) - [安装](#安装) - [项目集成](#项目集成) - [设计支付系统](#设计支付系统) - [支持的接口](#支持的接口) - [贡献指南](#贡献指南) - [代码设计](#代码设计) - [接入支付指南](#接入支付指南) - [第三方文档](#第三方文档) - [License](#License) # 公告 第三方支付的一些重要更新提示，以及项目相关的计划信息。 ## 重要通知 1. 2019-04: **提醒：微信CA证书进行了更新，请更新项目到最新版本。否则5月29日后，将无法支付** > 官方公告： https://pay.weixin.qq.com/index.php/public/cms/content_detail?lang=zh&id=56602 ## 计划 1. 2019/3/28 开始重构整个项目，doing... ... > 重构后的项目与 `4.x` 以前的版本不兼容，请使用者注意！ # Payment解决什么问题 `Payment` 的目的是简化大家在对接主流第三方时需要频繁去阅读第三方文档，还经常遇到各种问题。`Payment` 将所有第三方的接口进行了合理的建模分类，对大家提供统一的接入入口，大家只需要关注自身业务并且支付系统设计上。 目前已经集成：支付宝、微信、招商绝大部分功能。也欢迎各位贡献代码。 [贡献指南](#贡献指南) # 如何使用 ## 安装 当前 `Payment` 项目仅支持 `PHP version > 7.0` 的版本，并且仅支持通过 `composer` 进行安装。 **需要 `PHP` 安装以下扩展：** ```txt - ext-curl - ext-mbstring - ext-bcmath - package-Guzzle ``` **composer安装方式：** 直接在命令行下安装： ```bash composer require "riverslei/payment:*" ``` 通过项目配置文件方式安装： ```yaml "require": { "riverslei/payment": "*" } ``` ## 项目集成 按照上面的步骤完成安装后，即可在项目中使用。 对于整个过程，提供了唯一的入口类 `\Payment\Client`，每一个渠道，均只介绍 `APP支付` 与 `异步/同步通知` 该如何接入。会重点说明每个请求支持的参数。 **APP支付demo** ```php $config = [ // 配置信息，各个渠道的配置模板见对应子目录 ]; // 请求参数，完整参数见具体表格 $payData = [ 'body' => 'test body', 'subject' => 'test subject', 'trade_no' => 'trade no',// 自己实现生成 'time_expire' => time() + 600, // 表示必须 600s 内付款 'amount' => '5.52', // 微信沙箱模式，需要金额固定为3.01 'return_param' => '123', 'client_ip' => isset($_SERVER['REMOTE_ADDR']) ? $_SERVER['REMOTE_ADDR'] : '127.0.0.1', // 客户地址 ];`` // 使用 try { $client = new \Payment\Client(\Payment\Client::WECHAT, $wxConfig); $res = $client->pay(\Payment\Client::WX_CHANNEL_APP, $payData); } catch (InvalidArgumentException $e) { echo $e->getMessage(); exit; } catch (\Payment\Exceptions\GatewayException $e) { echo $e->getMessage(); var_dump($e->getRaw()); exit; } catch (\Payment\Exceptions\ClassNotFoundException $e) { echo $e->getMessage(); exit; } catch (Exception $e) { echo $e->getMessage(); exit; } ``` **异步/同步通知** ```php // 自己实现一个类，继承该接口 class TestNotify implements \Payment\Contracts\IPayNotify { /** * 处理自己的业务逻辑，如更新交易状态、保存通知数据等等 * @param string $channel 通知的渠道，如：支付宝、微信、招商 * @param string $notifyType 通知的类型，如：支付、退款 * @param string $notifyWay 通知的方式，如：异步 async，同步 sync * @param array $notifyData 通知的数据 * @return bool */ public function handle( string $channel, string $notifyType, string $notifyWay, array $notifyData ) { //var_dump($channel, $notifyType, $notifyWay, $notifyData);exit; return true; } } $config = [ // 配置信息，各个渠道的配置模板见对应子目录 ]; // 实例化继承了接口的类 $callback = new TestNotify(); try { $client = new \Payment\Client(\Payment\Client::ALIPAY, $config); $xml = $client->notify($callback); } catch (InvalidArgumentException $e) { echo $e->getMessage(); exit; } catch (\Payment\Exceptions\GatewayException $e) { echo $e->getMessage(); exit; } catch (\Payment\Exceptions\ClassNotFoundException $e) { echo $e->getMessage(); exit; } catch (Exception $e) { echo $e->getMessage(); exit; } ``` 从上面的例子简单总结下，所有的支持的能力，通过 `\Payment\Client` 对外暴露方法；所有需要的常量也在这个类中进行了定义。其次需要一个 `$config`，关于config的模板，在每个渠道下面去看。最后一个传入请求的参数，完整的参数会在每个渠道中列出来，需要说明的是这些参数名字根据第三方文档部分进行了改写。在使用的时候请注意。 参数选项说明： - Y: 必须 - N: 非必须 ### 支付宝 **配置文件模板** ```php $config = [ 'use_sandbox' => true, // 是否使用沙盒模式 'app_id' => '2016073100130857', 'sign_type' => 'RSA2', // RSA RSA2 // 支付宝公钥字符串 'ali_public_key' => '', // 自己生成的密钥字符串 'rsa_private_key' => '', 'limit_pay' => [ //'balance',// 余额 //'moneyFund',// 余额宝 //'debitCardExpress',// 借记卡快捷 //'creditCard',//信用卡 //'creditCardExpress',// 信用卡快捷 //'creditCardCartoon',//信用卡卡通 //'credit_group',// 信用支付类型（包含信用卡卡通、信用卡快捷、花呗、花呗分期） ], // 用户不可用指定渠道支付当有多个渠道时用“,”分隔 // 与业务相关参数 'notify_url' => 'https://dayutalk.cn/notify/ali', 'return_url' => 'https://dayutalk.cn', ]; ``` #### APP支付请求参数 > 对应channel： \Payment\Client::ALI_CHANNEL_APP 字段 | 解释 | 必须 ---|---|--- amount | 订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000] | Y goods_type | 商品主类型 :0-虚拟类商品,1-实物类商品 | Y body | 对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body。 | Y subject | 商品的标题/交易标题/订单标题/订单关键字等。 | Y product_code | 销售产品码，商家和支付宝签约的产品码 | N trade_no | 商户网站唯一订单号 | N promo_params | 优惠参数 注：仅与支付宝协商后可用 | N return_params | 公用回传参数，如果请求时传递了该参数，则返回给商户时会回传该参�