文档中心 > 旅游度假

交易非实时同步对接方案

更新时间:2017/12/01 访问次数:11410

交易非实时同步对接

该方案可实现飞猪平台订单同步至商家系统,同时支持商家通过API接口修改飞猪订单状态,推进订单流程。交易订单非实时同步对接方案流程如下图,图中虚线框为可选流程:

image

订单创建

飞猪系统告知商家有新订单产生,商家获取订单信息并在商家系统创建对应订单。商家获取飞猪平台订单信息有以下两个步骤:
步骤一、获取飞猪平台交易订单id。

  • 推荐方案:在淘宝开放平台订阅消息服务:alitrip_travel_OrderChanged。当飞猪平台有新订单产生、付款时,消息服务会主动通知到商家系统 有新订单产生并附带上飞猪平台的订单id。该方案的优点:实时;缺点:消息存在延迟、丢失、重复的可能,需要商家处理好异常情况。
  • 备选方案:商家系统定期调用订单列表搜索接口,获取尚未处理的订单:alitrip.travel.trades.search。该方案的优点在于商家可以主动获取订单列表;缺点是对新订单的处理不够实时,需要定期轮询。

步骤二、根据飞猪订单id获取订单详情。商家可以调用飞猪提供的订单详情接口(alitrip.travel.trade.query)获取到飞猪订单的详情信息(如买卖家信息、出行人信息等),然后实现在商家系统创建对应的订单。

注:关于消息服务的说明

订单发货

商家系统在获知并创建了对应的订单信息后,需要及时对该订单进行处理:

  • 情况一:确认发货。商家确认有资源可以对该笔订单进行发货,则需要回调飞猪平台提供的订单发货接口(alitrip.travel.trade.deliver),实现飞猪平台上订单的发货处理。特别的,针对即时确认订单的场景,卖家无需进行发货处理,因为即时确认类商品产生的订单在买家付款后将自动发货成功。
  • 情况二:拒绝发货。商家确认已经没有资源可以对该笔订单进行发货,则需要人工联系买家申请退款。特别的,针对二次确认订单的场景,飞猪平台提供了订单关闭接口,即由卖家发起的快速退款(alitrip.travel.trade.close),实现卖家主动关闭无法发货订单,快速退款给买家。

注:关于即时确认和二次确认的说明

用户取消订单

如果买家在飞猪平台对一笔已付款订单发起退款,飞猪系统将告知商家该事件,商家需要在自身系统对该笔订单发起取消流程并进行处理。该场景同样存在两种方案:

  • 推荐方案:在淘宝开放平台订阅消息服务:alitrip_travel_OrderChanged。当飞猪平台有订单申请退款,消息服务会主动通知到商家系统。
  • 备选方案:商家系统定期调用订单列表搜索接口(alitrip.travel.trades.search),获取发起退款的订单列表并进行处理。

飞猪度假 交易类API接口开放

订单消息服务 - alitrip_travel_OrderChanged

  • 飞猪度假交易订单消息通知服务,如果商家应用订阅该消息服务,则当飞猪度假订单有状态变化时会主动通知到商家应用。目前支持的消息产生条件:订单产生,订单已付全款,订单关闭,订单已发货,订单已完成,订单已付定金(只有分阶段付款的预售商品订单才有)。
  • 请注意,order_status=2代表订单已付全款。对于预售商品订单,已付定金消息对应的order_status=6。
  • 订单消息内容如下表所示。
字段名称 字段描述 字段类型 是否可以为空 示例值
buyer_nick 买家昵称 string buyer11
gmt_created 订单创建时间 Date 2017-01-11 15:30:01
gmt_modified 订单上一次修改时间 Date 2017-01-11 15:30:01
item_infos 该主订单下子订单列表所对应的商品信息列表,多个以英文逗号分隔。商品信息格式为:类目id:商品id:商品级别商家编码:sku级别商家编码 string 123456:2333:outProId:outSkuId,123456:2333:outProId:outSkuId11
order_id 主订单id long 12345678
order_status 订单状态。1-订单创建,2-订单已付款(已付全款),3-订单已关闭,4-订单已发货,5-交易成功,6-订单已付定金(只有预售商品订单才有) int 1
seller_nick 卖家昵称 string seller11

订单搜索接口 - alitrip.travel.trades.search

  • 飞猪度假交易订单搜索服务,基于订单创建时间进行搜索,同时支持按照订单基本状态进行过滤。预留扩展字段,以支持更多过滤条件支持。

订单详情接口 - alitrip.travel.trade.query

  • 通过主订单id获取一笔订单详情信息:主订单详情(基本信息+支付信息+优惠信息+买家信息+卖家信息)+子订单详情(商品相关信息(包含各业务订单特有扩展信息)+出行人信息+联系人信息)。该订单详情接口为通用接口,支持度假、门票、签证等业务类型订单。
  • 部分用户隐私信息字段经过了模糊化处理,需要满足集团安全条件才能获取到明文数据。具体对接安全整改请参考:(待定)
  • 该订单详情接口同时也支持 分阶段付款的预售商品订单。对于预售订单,根据主订单信息中type字段值进行判断(预售订单值为step,一口价订单值为fixed)。如果是预售订单,主订单支付信息(pay_info)中会包含分阶段付款明细信息,详见字段step_paid_fee,step_trade_status

订单发货接口 - alitrip.travel.trade.deliver

  • 无物流虚拟商品发货接口,实现卖家对一笔子订单的确认发货。支持以下业务类型:
    1、二次确认订单:支持对二次确认订单进行资源确认成功操作(资源确认成功后订单自动触发发货)
    2、支持 手工电子票、自取型wifi/电话卡、流量充值 订单的卖家发货功能
    3、(预留,暂不支持)支持 邮寄型wifi/电话卡 订单发货(需要物流)

订单关闭接口 - alitrip.travel.trade.close

  • 卖家发起关闭一笔子订单,支持以下业务类型及情况:
    1、订单已付款(卖家快速退款):卖家主动关闭一笔已付款订单,针对特殊业务、个别授信卖家开放
    2、二次确认订单:支持对二次确认订单进行资源确认失败操作(资源确认失败后订单触发自动退款)

FAQ

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