接入前必读

传值注意事项

  1. 时间格式具体看字段对应的释义,一般遵循 xxDate是yyyy-mm-dd;xxDatetime是yyyy-mm-dd hh:mm:ss;另外有部份字段是需要提供时间戳的。

  2. 订单金额传值存在负数的情况,在改签和退票的场景下产生两个单号的情况下改签单和退票单存在传负数的情况。简单来说,对于单笔资金流向,如果是客户付给消费服务商,则为正,如果是消费服务商退还给客户,则为负。比如:预定机票,客户付给消费服务商票款1000,price为+1000;后续退票,退票款1000元,但是收取600元退票费,则price为-1000,但是refund_price为600。预定订单总额1000元,退票订单-1000+600元=-400元。多订单号金额计算逻辑参考示例如下:

    2.1 飞机

    Image Alt Text

    2.2 酒店

    Image Alt Text

    2.3 火车

    Image Alt Text

  3. 如果订单推送时返回系统异常,建议每5分钟再推送一次,最多自动推送3次。如果3次后依然不能推送成功,则记录推送失败,对接群里沟通处理方案。

  4. 目前获取sessionId时,会传递userNo字段,需要基于用户生成token。但是实际运行下来,sessionId全程没有提供到页面,因此后面会考虑增加V2版本的sessionId,仅基于account生成token,作为公司级别的sessionId。

  5. 大部份请求接口口,都提供了13位时间戳的timestamp字段作为请求时间,如果此时间与当下时间差异过大,建议判定请求失效。

results matching ""

    No results matching ""