接口实现功能
合作协议
中顺票务提供给运营商的参数
运营商提供给中顺票务的回调地址:
自我游系统发布及设置
测试环节
订单退款
常见问题
修改日期:20170815
修改人:莫润乐
中顺票务供应接口
接口实现功能
下单同步(运营商下达通知单时才会下单到中顺票务系统)
取消订单时同步(同步)
订单退款(支持)
查看对方订单详情(支持)
查看对接订单日志(支持)
返码(支持)
重新发码(不支持)
系统自动核销订单(支持)
****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款如有问题,请联系自我游公众号:自我游运营中心
合作协议
(运营商与中顺票务之间的合作协议)
中顺票务提供给运营商的参数
运营商提供给中顺票务的回调地址:
订单验证通知地址:http://运营商域名/api/zhongshunpiaowu/finish.jsp
退款审核通知地址:http://运营商域名/api/zhongshunpiaowu/cancelReturn.jsp
自我游系统发布及设置
1、运营商给中顺票务接口开一个供应商账号,用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通,参考该链接:http://kf.zowoyoo.cn/hc/kb/article/191732/】
2、客人资料要求选择【只需要输入一个客人资料】,客人必填信息选择【姓名】、【手机号码】、【身份证号码】,如图:
3、产品生成通知单控制设置为:在预付(支付成功后自动锁定订单,无需生成通知单,自我游系统的订单是下达通知单才同步到中顺票务系统,如图:
4、产品详情界面接口信息的设置:由自我游配置好接口之后才会显示,如图:
5、产品编码设置:
点击【接口从编号参考】进去查看到的票种信息中的编码,如图:
产品编码根据上图绑定编码
测试环节
下单:使用分销商账号进行下单并支付,需定位相关分销商并填写上相关的游玩日期、预定票数、游玩客人姓名、手机号、身份证号码;下单成功之后,可以通过自我游后台订单详情界面查看对方订单详细内容。
订单退款
自我游系统先发起退款申请,发起了退款申请后运营商处理退改申请,退款的要求会下达到中顺票务系统那边,需要等待中顺票务系统审核,该接口支持部分退款但【只支持申请退一次】。
1.订单状态是已安排:分销商登录系统,【订单管理】点击【退改申请】,运营商在退改申请功能里允 许取消并点击退款后,取消的申请才会下发到中顺票务系统。然后中顺票务系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。中顺票务系统返回取消成功后,自我游系统的订单直接显示“撤单”.
2.订单状态为已完成:分销商先线下联系运营商,然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后,取消的申请才会下发到中顺票务系统。然后中顺票务系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。中顺票务系统返回取消成功后,自我游系统的订单直接显示“撤单”。
常见问题
问题描述:订单出现异常
解决办法:通过点击【查看详细的接口日志】可以查看本订单的日志,如图: