通过有赞云实现个人在线支即时到账

Posted by Nathan on 2018-12-07

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

思路是:

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

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

环境准备

第一步:开通微小店

去这里注册并开通小店:有赞微小店微店怎么开微店网页登录/下载 - 做生意,用有赞

第二步:注册有赞云

去这里注册个人开发者:有赞云 - 做软件,用有赞云,然后创建自用型应用,默认微商城,填写应用名称点下一步,授权店铺,选择你上面开通的小店名称并完成授权绑定。

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

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

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

环境已经准备 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 创建二维码,以我的包为例(大同小异啦):

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

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

1
2
3
"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 表用于专门记录支付记录)

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

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

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

第二步:主动查询订单

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

1
2
3
4
5
6
7
8
9
10
11
$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 才能查出我们订单的关联信息。

1
2
3
4
5
6
7
8
9
10
11
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% 的手续费感觉其实还好吧,毕竟你的个人站交易也大不到百万千万这样的额度去。

相关资料:

有赞云:www.youzanyun.com

微小店:有赞微小店微店怎么开微店网页登录/下载 - 做生意,用有赞

收银台 API: 收银台API - 有赞云

交易 API: 商家管理订单API - 有赞云

overtrue/laravel-youzan: overtrue/laravel-youzan

HanSon/youzan-sdk: HanSon/youzan-sdk

官方 SDK:youzan/open-sdk-php