武义牛头山门票供应商接口
接口实现功能
合作协议
义牛头山系统提供参数
运营商需要提供的参数
自我游技术需要提供参数给武义牛头山
自我游系统发布及设置
测试环节
订单退款
常见问题
修改日期:20170728
修改人:符娇珠
武义牛头山门票供应商接口
接口实现功能
返码(支持)
下单(订单出票时武义牛头山才来抓取自我游订单状态)
取消订单(不支持部分退款)
查看订单详细(不支持)
查看订单日志(支持)
查看对方订单详情(支持)
重新发码(不支持)
主动抓取核销信息(不支持)武义牛头山验证设备验证订单时系统订单即可同步验证
****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款如有问题,请联系自我游公众号:自我游运营中心
合作协议
(运营商与义牛头山系统之间的合作协议)
义牛头山系统提供参数
设备编号为武义牛头山的验证设备编号,多个验证设备时,配置参数时设备号用英文逗号分开,如设备号为624和623,那么配置时是624,623。
运营商需要提供的参数
运营商可以随便定义用户名和密码,然后把用户名和密码给武义牛头山技术配置即可。
自我游技术需要提供参数给武义牛头山
验证检查推送地址 http://saas.zowoyoo.com/api/niutoushan/verifyCheck.jsp
订单查询推送地址 http://saas.zowoyoo.com/api/niutoushan/verifyDetail.jsp
出票通知(核销)推送地址 http://saas.zowoyoo.com/api/niutoushan/verifyFinish.jsp
自我游系统发布及设置
1. 系统【产品管理】→【产品发布】选择“门票”类型发布产品。
2. 供应商:选择新增加的对应武义牛头山供应商名称,运营商给武义牛头山接口开一个供应商账号,用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通,参考该链接: http://kf.zowoyoo.cn/hc/kb/article/19173/ 】3. 票种可根据产品的票种来选择,该选择可显示在武义牛头山的验证设备给客人打印的小票中。
4. 产品生成通知单需设置为:在预订(支付)成功后自动锁定订单,无需生成通知单。
5. 出票短信,短信内容编辑中需要加入 $excode$ 代表入园验证码、$excode2$代表二维码 。
对应接口:由自我游配置好接口后才会显示。选择配置好武义牛头山
产品编号:可自行定义
测试环节
使用分销商账号进行下单并支付。
订单退款
【订单退款流程只能通过自我游系统操作退款,运营商不能直接到供应商系统进行退款】
订单状态——》已出票:分销商登录系统,【订单管理】点击【退改申请】,运营商在退改申请功能里允 许取消并点击退款后,取消的申请才会下发到武义牛头山门票系统。然后武义牛头山门票系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。武义牛头山门票系统返回取消成功后,自我游系统的订单直接显示“撤单”。
订单状态——》完成:分销商先线下联系运营商,然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后,取消的申请才会下发到武义牛头山门票系统。然后武义牛头山门票系统返回是否取消成功的值(返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看)。武义牛头山门票系统返回取消成功后,自我游系统的订单直接显示“撤单”。
常见问题
问题描述:订单出现异常?
解决方法:通过点击“查看详细的接口日志”可以查看本订单的日志