文档中心 > API类目 > 飞猪推广平台

alibaba.fliggy.cps.flight.buy (四海通机票企业级交易代扣)

四海通机票企业级交易代扣

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
si_hai_tong_flight_auto_pay_create_order_request SiHaiTongFlightAutoPayCreateOrderRequest 必须 请求参数体
  • └ activity_id
  • String
  • 必须
  • sht_xxx_xxx
  • 四海通活动id
  • └ promotion_position_id
  • Number
  • 必须
  • 200000000000
  • 四海通推广位id
  • └ fliggy_app_key
  • Number
  • 可选
  • 20000000
  • 四海通媒体id
  • si_hai_tong_item_params
  • SiHaiTongTradeFlightItemParam []
  • 必须
  • 商品参数
  • └ linked_id
  • String
  • 可选
  • fqefqweq
  • 前端带入的埋点,没有可以不传
  • └ item_id
  • Number
  • 必须
  • 1000
  • 商品id
  • └ quantity
  • Number
  • 必须
  • 1
  • 商品数量,非乘机人数量,从ota页透传
  • └ type
  • Number
  • 必须
  • 1
  • 类型1国内机票2国际机票 目前只支持传1
  • └ ota_item_id
  • String
  • 必须
  • fqefqweq
  • ota货架的商品项id
  • └ sku_id
  • Number
  • 可选
  • 0
  • skuid没有可以不传
  • └ is_skip_ic_client
  • Boolean
  • 可选
  • true
  • ota页透传,若有,不传会生单失败
  • └ new_build_order
  • Boolean
  • 可选
  • true
  • ota页透传,若有,不传会生单失败
  • └ new_link
  • Boolean
  • 可选
  • true
  • ota页透传,若有,不传会生单失败
  • └ item_index
  • Number
  • 可选
  • 0
  • ota页透传,若有,不传会生单失败
  • passenger_params
  • SiHaiTongPassengerParam []
  • 必须
  • a
  • 出行人参数
  • └ passenger_id
  • Number
  • 必须
  • 13123123
  • 出行人id
  • └ cert_id
  • Number
  • 必须
  • 23123123
  • 出行人选择的证件id
  • si_hai_tong_contact_param
  • SiHaiTongContactParam
  • 必须
  • 联系人参数
  • └ contact_id
  • Number
  • 可选
  • 123123123
  • 联系人id(若没有则传联系号码和联系人姓名)
  • └ phone
  • String
  • 可选
  • 10086
  • 联系号码
  • └ contact_name
  • String
  • 可选
  • 张三
  • 联系人姓名
  • └ out_serialize_no
  • String
  • 可选
  • ddqwdq
  • 外部唯一序号,防止重复提交,不传则按用户 + otaItemId防重,建议传递
  • validate_params
  • SiHaiTongTradeFlightValidateParam []
  • 可选
  • a
  • 二次校验确认参数(将第一次校验返回的校验type对应的count+1塞入这个入参中)
  • └ validate_type
  • String
  • 可选
  • ADD_BOOK_TIP_VALIDATE
  • 校验类型
  • └ count
  • Number
  • 可选
  • 1
  • 校验次数

响应参数

名称 类型 示例值 描述
is_success Boolean true 是否成功
result_code String 200 错误码
model SiHaiTongFlightAutoPayCreateOrderResponse 返回数据体
  • └ tp_order_id
  • String
  • 12312312312312
  • 返回创建成功的主订单号,是一个多个订单号的字符串,按逗号分隔,后续支付使用要拆开)
  • └ order_id
  • String
  • 13223123
  • 返回创建成功的订单号,是多个订单号组成的字符串按逗号分隔
result_message String 参数错误 错误提示
ext_info Json a 拓展值

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaFliggyCpsFlightBuyRequest req = new AlibabaFliggyCpsFlightBuyRequest();
AlibabaFliggyCpsFlightBuyRequest.SiHaiTongFlightAutoPayCreateOrderRequest obj1 = new AlibabaFliggyCpsFlightBuyRequest.SiHaiTongFlightAutoPayCreateOrderRequest();
obj1.setActivityId("sht_xxx_xxx");
obj1.setPromotionPositionId(200000000000L);
obj1.setFliggyAppKey(20000000L);
List<AlibabaFliggyCpsFlightBuyRequest.SiHaiTongTradeFlightItemParam> list3 = new ArrayList<AlibabaFliggyCpsFlightBuyRequest.SiHaiTongTradeFlightItemParam>();
AlibabaFliggyCpsFlightBuyRequest.SiHaiTongTradeFlightItemParam obj4 = new AlibabaFliggyCpsFlightBuyRequest.SiHaiTongTradeFlightItemParam();
list3.add(obj4);
obj4.setLinkedId("fqefqweq");
obj4.setItemId(1000L);
obj4.setQuantity(1L);
obj4.setType(1L);
obj4.setOtaItemId("fqefqweq");
obj4.setSkuId(0L);
obj4.setIsSkipIcClient(true);
obj4.setNewBuildOrder(true);
obj4.setNewLink(true);
obj4.setItemIndex(0L);
obj1.setSiHaiTongItemParams(list3);
List<AlibabaFliggyCpsFlightBuyRequest.SiHaiTongPassengerParam> list6 = new ArrayList<AlibabaFliggyCpsFlightBuyRequest.SiHaiTongPassengerParam>();
AlibabaFliggyCpsFlightBuyRequest.SiHaiTongPassengerParam obj7 = new AlibabaFliggyCpsFlightBuyRequest.SiHaiTongPassengerParam();
list6.add(obj7);
obj7.setPassengerId(13123123L);
obj7.setCertId(23123123L);
obj1.setPassengerParams(list6);
AlibabaFliggyCpsFlightBuyRequest.SiHaiTongContactParam obj8 = new AlibabaFliggyCpsFlightBuyRequest.SiHaiTongContactParam();
obj8.setContactId(123123123L);
obj8.setPhone("10086");
obj8.setContactName("张三");
obj1.setSiHaiTongContactParam(obj8);
obj1.setOutSerializeNo("ddqwdq");
List<AlibabaFliggyCpsFlightBuyRequest.SiHaiTongTradeFlightValidateParam> list10 = new ArrayList<AlibabaFliggyCpsFlightBuyRequest.SiHaiTongTradeFlightValidateParam>();
AlibabaFliggyCpsFlightBuyRequest.SiHaiTongTradeFlightValidateParam obj11 = new AlibabaFliggyCpsFlightBuyRequest.SiHaiTongTradeFlightValidateParam();
list10.add(obj11);
obj11.setValidateType("ADD_BOOK_TIP_VALIDATE");
obj11.setCount(1L);
obj1.setValidateParams(list10);
req.setSiHaiTongFlightAutoPayCreateOrderRequest(obj1);
AlibabaFliggyCpsFlightBuyResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_fliggy_cps_flight_buy_response>
    <is_success>true</is_success>
    <result_code>200</result_code>
    <model>
        <tp_order_id>12312312312312</tp_order_id>
        <order_id>13223123</order_id>
    </model>
    <result_message>参数错误</result_message>
    <ext_info>a</ext_info>
</alibaba_fliggy_cps_flight_buy_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部