利用有赞云和有赞微小店实现个人收款解决方案
利用有赞云和有赞微小店实现个人收款解决方案, 提供如下两个服务:
核心原理是提供了一个支付中转层,将自有商户订单与有赞云的订单绑定起来,实现支付状态更新
为什么做成单独的服务:
注册有赞云 开发者
创建有赞微小店 并扫码下载相应 APP 便于后续管理资金,注意这个小店在有赞后台看不到,只有 APP 可见
应用授权-有赞云控制台创建自用型应用并授权刚创建的店铺,在[推送服务]设置中设置推送网址http://www.example.com/api/status , 同时勾选下方的交易消息选项。
envrc.sample
为envrc
并填写其中:
YOUZANYUN_CLIENT_ID
: 有赞云应用的 client_id
YOUZANYUN_CLIENT_SECRET
: 有赞云应用的 client_secret
YOUZAN_KDT_ID
: 有赞云应用绑定的微小店 ID
SELF_SECRET
: 自有订单系统接收本服务推送数据的加盐 secret
PUSH_API
: 自有订单系统接收本服务推送数据的地址
npm run start // 启动服务
npm run list // 查看服务列表及状态
npm run stop // 停止服务
接入自有商店订单系统,支付时请求服务生成收款二维码
http://www.example.com/api/payment/qrcode
POST application/json
name
: 商品名, price
: 价格(分), order_id
: 自有系统的订单号qr_id
: 二维码 ID; qr_url
: 有赞系统内支付地址(不推荐使用,需要付费者注册有赞); qr_code
: Base64 图片数据,可直接作为 img 的 src 使用null
curl -X POST -H 'Content-type: application/json' --data '{"name":"test name", "price": 1, "order_id": "your orderid"}' http://www.example.com/api/payment/qrcode
接收状态推送自有订单系统提供一个PUSH_API
地址接收数据推送,数据格式如下:
{
"tradeNo": "E20180201105656001353613-6377801",
"orderId": "1515174485676262",
"payment": 10,
"status": "TRADE_SUCCESS",
"sign": "c857c0f8d52ae9713a77b5c07dda93dc",
"time": "1517457474"
}
其中 sign 是time
,tradeNo
,orderId
,payment
,status
,SELF_SECRET
使用"|"拼接字符串的 MD5 特征值,请在状态接收端按此逻辑进行校验数据合法性
此外 status 的 enum 如下:
enum YZBusinessStatus {
// 等待买家付款
WAIT_BUYER_PAY = "WAIT_BUYER_PAY",
// 待确认,包括(待成团:拼团订单、待接单:外卖订单)
WAIT_CONFIRM = "WAIT_CONFIRM",
// 等待卖家发货,即:买家已付款
WAIT_SELLER_SEND_GOODS = "WAIT_SELLER_SEND_GOODS",
// 等待买家确认收货,即:卖家已发货
WAIT_BUYER_CONFIRM_GOODS = "WAIT_BUYER_CONFIRM_GOODS",
// 买家已签收
TRADE_BUYER_SIGNED = "TRADE_BUYER_SIGNED",
// 交易成功
TRADE_SUCCESS = "TRADE_SUCCESS",
// 交易关闭
TRADE_CLOSED = "TRADE_CLOSED"
}
一般处理TRADE_SUCCESS
和TRADE_CLOSED
即可,返回 200 状态表示处理成功