对接说明:自我游商户将产品分销给第三方平台(并非 OTA 渠道平台),例如:驴妈妈、天时同城、票付通、标点云等,对方作为 分销方、自我游作为供应方。
特别说明:用以下开发文档开发的自我游API接口是1.0版本
目前1.0版本api仅支持 门票、抢购、套餐产品类目,需要对接其它产品类目需要使用2.0api接口
温馨提示:第三方平台采购自我游产品对接指南2.0版本操作手册
http://kf.zowoyoo.cn/hc/kb/article/1541397/
操作步骤:
第三方平台分销自我游商户的产品,商户需提供以下参数给第三方运营人员配置
1. 分销商ID
2. Apikey
3.接口地址:商户在自我游的系统网址(必须带http://)
注意:不同的第三方平台对上述3个参数叫法略有不同
APIkey获取步骤:
登录自我游系统,在左边功能列表找到【合作伙伴】-【分销商管理】,新增一个分销商(该分销商专门用于对接该渠道),创建后找到对应的分销商—》点击【管理】—》再点击管理旁边的【接口地址】然后 点击 apikey 旁边的“立即生成 apikey”,即可.如下图
分销商接口支付方式设置如下:
在合作伙伴-分销商管理,点击【管理】进入找到接口支付方式,接口对接支持两种支付方式,预存款扣除与授信扣除
预存款扣除:需要分销方登录对接的分销后台充值,此支付方式是一单一结
授信扣除:分销方先线下转款、运营商授予额度,或者是后续再对账向分销方收款(授信方式有风险,一般 仅给商户内部分销商使用)
(如果该接口是商户自己内部使用,可以使 用授信支付,并且额度设置大一些。每次节假日前应检查该授信额度是否足够。);
注意:如分销商接口支付方式选择授信扣除方式,需同时设置授信,授信额度设置操作步骤如下
完成以上操作后,可咨询对方平台是否会提供回调地址(作用:用于同步自我游系统订单变更信息),如有收到回调即配置到分销商管理前面生成APIkey的设置页面,根据对方提供的回调名称对应配置进来;完成后自我游商家可提供产品编号 给分销方进行下单测试,如测试通过,表示对接成功
退款注意事项
温馨提示:需跟平台工作人员核实是否有如逾期未处理自动退款规则,请遵循平台要求按时处理订单,如逾期未处理造成损失,自行承担。关于退改时限要求会有调整,请以各平台官方通告为准。
1、自营订单退款处理
①如接口要求自营产品需要人工审核,第三方平台发起退款申请,自我游商户必须在自我游系统【退改申请处理】,点击【处理】。自我游商户请勿对订单做异常处理,此操作退款状态是无法同步到第三方平台。
2、对接第三方供应商系统的订单退款处理
①客人在第三方平台发起退款申请,该订单对接的供应商接口还没升级自动推送退款请求,自我游商户需在自我游系统针对订单操作“异常处理”,选择“允许取消”保存后,再点击“退款”。接口自动将退款信息推送给供应商,等供应商返回退款处理结果。(退改申请处理里暂时不要进行任何操作) ,供应商同意退款,运营商再回到自我游【退改申请处理】,点击【处理】“同意取消”。若供应商拒绝退款,点击“拒绝取消”。状态会直接同步到第三方平台。
②该订单对接的供应商接口还没升级自动推送退款请求,商户想实现自动推送退款请求给到供应商接口,自我游系统产品可设置退款规则,客人发起退款申请时,自我游系统会自动将退款请求推送给供应商接口,等供应商返回退款处理结果。自我游会将“同意”或“拒绝”状态推送给第三方平台。PS:该设置以实际下单退款后结果为准,因不是所有供应商接口都支持,在设置之后下单测试后产品再上线
③客人在第三方平台发起退款申请,该订单对接的供应商接口可实现自动推送退款请求,接口自动将退款信息推送给供应商,等供应商返回退款处理结果。(退改申请处理里暂时不要进行任何操作) ,等供应商返回“同意退款”或“拒绝退款”状态给自我游,自我游再推送给第三方平台。