有赞云开发者大赛 - 收银台定制场景文档

目标场景

在过往的经营中,商家的系统已经和三方支付渠道(微信,支付宝,银联等等)建立了联结,或是分期付款,或是小额金融,亦或是储值卡,礼品卡等客户资产,并开发了成熟的互联网支付收银台(H5)。因此,商家在接入有赞商城时,希望可以修改和定制有赞微商城的收银流程,在结算页(下单页)买家点击结算时,跳转商家的自建收银台,从而适配商家自建的收银体系。在完成收银或者触发逆向流程(例如退款)的时候,也需要商家将付款信息的变动传回到有赞。

业务流程

支付流程

订单取消 - 已支付 - 退款

订单取消 - 未支付 - 失效支付单

技术方案

正向交易(付款)

​ 1. 实现去支付扩展点 ,买家下单时商城调用有赞云 ISV 应用的去支付扩展点实现,等待返回第三方收银台地址。

​ 2. 有赞云 ISV 应用去支付扩展点实现中调用第三方系统信息对接接口,返回第三方收银台地址。

​ 3. 有赞商城跳转到第三方收银台,买家支付完成后,跳转到支付信息展示页。

​ 4. 第三方支付完成后调用有赞云 ISV 应用支付回调接口,开发者需在有赞云 ISV 应用中调用支付完成通知 API(youzan.trade.outside.pay),通知有赞商城支付成功,跳转支付成功页

逆向交易(退款)

​ 1. 实现退款扩展点 ,买家发起退款时商城调用有赞云 ISV 应用的退款扩展点实现。

​ 2. 有赞云 ISV 应用实现的退款扩展点中调用第三方系统的退款接口。

​ 3. 第三方系统完成退款后调用有赞云 ISV 应用中的退款成功回调接口,开发者需在有赞云 ISV 应用中调用退款完成通知 API(youzan.trade.extpoint.refund.pay.result.create),通知有赞商城退款成功

取消未付款订单

1. 有赞商城发布一个订单取消的消息,开发者需在有赞云 ISV 应用上实现订单取消消息扩展点订阅消息。

2. 有赞云 ISV 应用接收到订单取消通知后,需调用第三方系统取消订单接口,将订单取消结果返回给有赞商城。

涉及扩展点 /API

扩展点 /API 名称 应用场景
去支付扩展点 支付跳转第三方收银台
youzan.trade.outside.pay 支付完成通知接口
退款扩展点 第三方收银台订单退款
youzan.trade.extpoint.refund.pay.result.create 退款完成通知接口
订单取消消息扩展点 订阅订单取消通知