README

利用有赞云和有赞微小店实现个人收款解决方案

Installation

使用 Composer 安装

$ composer require slince/youzan-pay

Basic Usage

• 创建 api 上下文和服务对象

$apiContext = new Slince\YouzanPay\ApiContext(CLIENT_ID, CLIENTD_SECRET, KDT_ID);

$youzanPay = new Slince\YouzanPay\YouzanPay($apiContext);

• 发起付款

$qrCode = $youzanPay->charge([
    'name' => '测试收款',
    'price' => 1, //单位是分
    'source' => '自身系统的订单id'
]);

echo  "<img src=\"{$qrCode->getCode()}\">"; //用户可以使用微信或者支付宝扫描付款

方法返回 Slince\YouzanPay\QRCode 对象。

• 验证付款

$qrCodeId = ...
$result = $youzanPay->checkQRStatus($qrCodeId);

var_dump($result); //布尔类型

• 处理推送

怎么设置推送网上有太多帖子这里不再赘述，假设你已经设置好了推送：

$data = $youzanPay->verifyWebhook($request); 

var_dump($data);

$request 对象可以是 Symfony\Component\HttpFoundation\Request， Psr\Http\Message\ServerRequestInterface, 这表示 symfony ， laravel， Sliex, CakePHP ，Slim 等框架用户可以直接将 request对象传给该方法； $request 也可以为null或者数组； 所以如果你不使用任何框架也可以很方便的集成；

如果是合法的有赞推送消息，$data 是一个数组，结构如下(注：下面是个json结构)

{
    "client_id":"6cd25b3f99727975b5",
    "id":"E20170807181905034500002",
    "kdt_id":63077,
    "kdt_name":"Qi码运动馆",
    "mode":1,
    "msg":"%7B%22update_time%22:%222017-08-07%2018:19:05%22,%22payment%22:%2211.00%22,%22tid%22:%22E20170807181905034500002%22,%22status%22:%22TRADE_CLOSED%22%7D",
    "sendCount":0,
    "sign":"5c15274ca4c079197c89154f44b20307",
    "status":"TRADE_CLOSED",
    "test":false,
    "type":"TRADE_ORDER_STATE",
    "version":1502101273
}

关于推送相关的文档可以参考 这里

接收到推送数据以后，你可以得到响应的 交易的id，但并不是你的订单id；用交易 id获取对应的二维码的id:

$trade = $youzanPay->getTrade($data['id']); //上一步获取的id

echo $trade->getQrId();  //获取到二维码id后去你的数据库查询到订单，做相应的处理；

$trade 是 Slince\YouzanPay\Trade 的实例；注意，为了聚焦业务，该对象只保留了原生数据的部分字段；

License

采用 MIT 开源许可证