交易实时同步对接
飞猪制定交易订单实时同步接口的规范,商家需要按照这些接口规范实现并提供对应的服务。飞猪交易系统在用户下单过程中适时触发调用外部商家提供的交易预定相关接口服务,实现飞猪平台订单实时同步至商家系统,同时提供了一系列交易订单相关的回调接口用于推进飞猪订单流程。
交易订单实时同步时序图如下:
交易订单实时同步接口定义
此处只定义抽象的接口规约,不涉及具体的接口定义。具体直连接口的定义和回调接口的定义详见各业务对应的订单实时同步方案。目前支持的业务:用车。其他业务待扩展支持!
订单验证接口
订单验证接口用于验证用户当前拍下的商品价格库存是否与商家系统中最新的价格库存一致,商家接口需要实时返回验证结果。该接口规约如下:
- 接口超时时间为5秒,即商家接口必须在5秒内返回验证结果。
预定接口
飞猪系统通过该接口传递必要的客户预定信息到商家系统,触发商家系统的客户预定流程。该接口规约如下:
- 1、接口超时时间为5秒,即商家接口必须在5秒内返回预定结果 或者 告知仍在预定中(商家系统无法在5秒内完成预定,则可以先告知仍在预定中,飞猪系统将按照一定策略轮询预定结果,详见第三点规约)。预定结果的轮询即调用商家提供的“查询订单接口”。
- 2、幂等性保证:商家提供的预定接口必须保证对于同一个飞猪订单id,该接口返回的商家系统订单号必须一样,即飞猪订单id和商家订单id必须一一映射。
- 3、预定结果轮询策略:在提交预定后的30分钟内,每隔3分钟查询1次预定结果。如果超过30分钟时限商家系统仍然没有返回预定结果,则将视为预定失败。
取消预定接口
如果用户在飞猪系统上取消预定,则飞猪系统将通过该接口触发商家系统的取消预定流程。该接口规约如下:
- 1、接口超时时间为5秒,即商家接口必须在5秒内返回取消结果 或者 告知仍在取消中(商家系统无法在5秒内完成取消预定,则可以先告知仍在取消中,飞猪系统将按照一定策略轮询取消结果,详见第三点规约)。
- 2、幂等性保证:商家提供的取消预定接口必须保证对于同一个飞猪订单id,商家系统取消的是同一笔商家订单。
- 3、取消预定结果轮询策略:在提交取消预定操作后的30分钟内,每隔3分钟查询1次取消预定结果。如果超过30分钟时限商家系统仍然没有返回取消预定结果,则将视为取消预定失败。
查询订单接口
飞猪系统通过调用商家提供的订单查询接口 实时查询商家系统的预定结果或者取消预定结果。该接口规约如下:
- 1、商家提供的订单查询接口,必须支持以飞猪订单号为主键的查询。
- 2、接口超时时间为5秒,即商家接口必须在5秒内返回查询结果。
- 3、幂等性保证:对于同一个飞猪订单id,返回的必须是同一笔商家订单。
FAQ
关于此文档暂时还没有FAQ