文档中心 > 京杭一键出票

京杭订单消息对接

更新时间:2021/03/23 访问次数:3261

 消息通知使用方法

 1、申请权限包

登录淘宝开放平台: //open.taobao.com/  ,点击 控制台

点击右上角 登录,输入开发者账号,登录密码,点击 登录

在页面中根据AppKey找到对应的应用,点击 应用管理

在应用的功能场景中选择: 机票_航变信息管理,点击右侧 申请权限。申请理由需要大于100字,可以描述使用场景和用途

提交成功后,状态是申请中,需要等待后台小二审核

审核通过后,应用就获取到了接受航变消息的权限包 状态:

 

2、登录TOP后台,消息订阅模块,订阅

应用管理页面,点击  消息服务---订阅消息

fliggy_jipiao_FlightChange                   **航变消息服务**,     点击右侧 订阅
taobao_jipiao_JipiaoOrderStatusNotify  **机票订单状态推送**
taobao_jipiao_JipiaoRefundOrderNotify **机票退票订单状态推送**

refund_status 退票状态 1:退票处理中 2:退票成功 3:退票失败
instant_refund_type 极速退款方式,0:非极速退款,1:实时退款,2:一小时退款
refund_type 退款类型 1:自愿2:非自愿

在 我的消息 里看到消息 已订阅,即订阅成功。如果订阅错误,可以取消订阅


3、调用taobao.tmc.user.permit接口给下单淘宝帐号开通消息通知,可以选择只给用户开通部分消息类型,也可全部开通。具体可看该API 入参说明。

备注:

  • 给用户开通消息前提是用户已经给应用授权,如未授权,请参考获取用户授权说明。
  • 这个接口全量接口,不支持增量(如已经授权过订单消息,现在要授权航变消息,要把订单消息,航变消息一起重新授权)
  • 取消用户的消息服务调用taobao.tmc.user.cancel接口。
  • 可以通过接口taobao.tmc.user.get获取用户已开通消息,入参必须输入is_valid,topics,modified来判断用户授权消息是否成功

针对采购商获取航变消息:采购账号授权,获取sessionkey

Sessionkey获取下线工具://open.taobao.com/apitools/sessionPage.htm?spm=a219a.7629140.0.0.Hr5BX5

输入接收消息的AppKey,点击 登录并授权,

再登录采购账号,点击 授权并登录。如果此时系统默认登录的账户不是采购账户,可以点击 切换,重新登录采购账号进行授权


4、[通过SDK接收消息](https://open.alitrip.com/docs/doc.htm.htm?articleId=101663&docType=1&treeId=2)

代码实现接收消息,代码示例:

 

出票相关消息通知触发场景:

  1. 订单关闭(余额不足,支付宝接口错误等原因超时未支付导致的订单关闭)
  2. 下单并支付成功
  3. 订单成功并有票号的通知。
  4. 订单强制成功(订单也下单成功,但由于各种原因,如订单无票号引发的订单强制成功,该状态随后会在票号回填后触发有票号的成功订单通知)

退票消息通知触发场景:每当订单的退票申请单有如下状态变化时,即刻产生通知:一个订单如有多个申请单,则每个申请单都将发起独立的消息通知,通知内容包括该订单的所有申请单当前状态信息.

  1. 申请单退款成功
  2. 申请单被卖家解决退款。

FAQ

关于此文档暂时还没有FAQ
返回
顶部