基于有赞云的个人收款即时到帐实现方案

overtrue

发布于 2018-07-05 11:34:12

2.1K0

发布于 2018-07-05 11:34:12

很多人都想出售自己的一些产品，课程，电子书，或者其它在线可售卖的东西，但是不管是微信支付还是支付宝，都需要公司账户，这一套不是不可以搞，就是太麻烦了而已。今天介绍的就是不需要公司账号实现个人收款的自动化方案（当然，交易 1% 手续费比微信等略高）。

思路是：

环境准备：在有赞开通微小店（免费）-> 注册有赞云 -> 创建自用型应用 -> 绑定微小店 -> 开通 push (推送交易状态)

交易流程：调用有赞云的收银 API ，创建支付二维码(并存储二维码 id 到自有网站订单) -> 用户扫描二维码并支付 -> 推送交易状态到你的网站 -> 更新网站订单状态 -> 完成购买

环境准备

第一步：开通微小店

去这里注册并开通小店：https://h5.youzan.com/v2/index/wxdpc

第二步：注册有赞云

去这里注册个人开发者：https://www.youzanyun.com/ ，然后创建自用型应用，选择你上面开通的小店名称并完成授权绑定。

第三步：开通应用动态推送

这一步主要是接收订单交易状态的，用户发起支付与支付完成都有推送消息，后面我们会介绍如何处理推送。

开通推送的方法：有赞云控制台 -> 应用设置 -> 开发信息 -> 修改 -> 填写接收推送的网址即可。

环境已经准备 OK 了，你的手机上应该已经装了微小店应用了，接下来我们要发起交易，开始之前我们得准备好 SDK，如果你使用 Laravel，我封了一个包：overtrue/laravel-youzan，如果你是其它框架，那么请使用 HanSon 的封装：HanSon/youzan-sdk。当然还有一个选择，官方 SDK：youzan/open-sdk-php。

安装完 SDK，配置环境我们需要一些参数：

client_id: 应用ID，在有赞云控制台 -> 应用设置页可以找到
client_secret 密钥，同样在应用设置页
kdt_id 其实就是原来的口袋通ID，就是应用设置页基本信息中的 “授权店铺id”

交易流程

第一步：创建收款二维码

这一步一般是用户在你的网站选择完商品，或者在购物车点结算，你在自己网站创建完订单后，调用有赞云收银 API 创建二维码，以我的包为例（大同小异啦）：

$result = \Youzan::request('youzan.pay.qrcode.create', [
                    'qr_type' => 'QR_TYPE_DYNAMIC',  // 这个就不要动了
                    'qr_price' => 100,  // 金额：分
                    'qr_name' => 'iPhone 8 plus 64G 金色', // 收款理由
                    'qr_source' => '102828399222', // 自定义字段，你可以设置为网站订单号
                ])'

得到的结果呢包含三个值：

"qr_id": "19707",
    "qr_url": "https://trade.koudaitong.com/wxpay/confirmQr?qr_id=19707&kdt_id=55",
    "qr_code": "data:image/png;base64,iV......"

其中 qr_id 你需要与刚才的订单绑定（这里取决于你自己的实现了，比如你在网站应该有 payments 表用于专门记录支付记录）

qrurl 呢其实就是扫码完打开的页面，qrcode 是图片内容，可以直接放到 img 的 src 中，data-url 格式。就是一个二维码图片。

用户扫码后打开一个网址完成付款。这时候你的手机 app 微小店会告诉你有新的订单。

接下来就是处理交易结果了。

第二步：主动查询订单

为啥要主动查询呢，不是有推送么，对，但是推送的时间以及成功率是无法保证的，所以我们应该主动去查询，我的做法是在交易创建完成后，定时（2秒左右）查询一次订单信息：

$payment = Payment::whereQrId('19707');
    $result = Youzan::request('youzan.trades.qr.get', [
         'qr_id' => $payment->qr_id, 
         'status' => 'TRADE_RECEIVED'
    ]);

    if ($result['total_results'] > 0) {
        $order = array_pop($result['qr_trades']);
        $payment->status = Payment::STATUS_SUCCEED;
        $payment->save();
    }

上面我们先从自己的数据库根据 qr_id 查询交易记录得到 $payment，然后调用了有赞云 API 的二维码订单列表得到这个二维码产生的成功的交易订单。

如果得到成功交易的订单数量大于 0 （一般就一笔），就更新支付状态为成功。

反之，继续查，这里一般有一个限制，比如查10次没有交易就关闭，或者其它你觉得 OK 的策略都可以。

第三步：处理推送

这一步与其它支付的情况不太一样，因为推送过来的内容不是直接就能与你的订单关联上的，推送过来的内容中有一个 id 字段，这是有赞的订单 ID ，不是我们的订单 ID，我们先要拿这个 ID 去他们的 API 取到交易详情，然后再从交易详情得到 qr_id 才能查出我们订单的关联信息。

if ($request->get('type') == 'TRADE_ORDER_STATE' 
        && $request->get('status') == 'TRADE_SUCCESS') {
        $order = Youzan::request('youzan.trade.get', ['tid' => $request->id]);

        $payment = Payment::WhereQrId($order['trade']['qr_id'])->first();

        if ($payment && $payment->status !== self::STATUS_SUCCEED) {
            $payment->status = Payment::STATUS_SUCCEED;
            $payment->save();
        }
    }

获取交易详情 API 为 youzan.trade.get，传入的 tid 就是推送内容里的 id。二维码 ID 在交易详情的 trade 里。

那这一套流程就实现完了，个人感觉还是非常容易的，收款完成你就可以在微小店提现了。

个人觉得这一套下来接入成本非常的低，然后还有一个非常大的好处是给你省去很多开发工作，因为在手机 app 上随时有推送，以及订单管理，每天的收益统计等，很方便，当然 1% 的手续费感觉其实还好吧，毕竟你的个人站交易也大不到百万千万这样的额度去。