有赞云开发者大赛 - 收银台定制场景文档
目标场景
在过往的经营中,商家的系统已经和三方支付渠道(微信,支付宝,银联等等)建立了联结,或是分期付款,或是小额金融,亦或是储值卡,礼品卡等客户资产,并开发了成熟的互联网支付收银台(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 | 退款完成通知接口 |
订单取消消息扩展点 | 订阅订单取消通知 |