接入前准备

通用能力

餐饮

大交通

酒旅

酒店行业新预售券解决方案

酒店行业日历房解决方案

度假行业解决方案

预售券

KA核销对账

日历品

旅行社日历品操作

旅行社日历品价量态操作

旅行社日历品行业交易商家接单

旅行社日历品行业交易可定检查

旅行社日历品行业交易创建订单

旅行社日历品行业交易支付结果通知

旅行社日历品行业交易退款成功通知

旅行社日历品-订单取消通知

酒旅-旅行社支付结果通知

旅行社poi查询

旅行社直连相关枚举&常见错误码

景区行业解决方案

通用错误码

综合

历史版本文档（不推荐）

旅行社日历品行业交易创建订单

我的收藏

三方对接请订单创单幂等：
•创单成功必须要返回out_order_id并维护好和order_id的幂等映射，超时会重试。研发请重点关注！！！

接口说明

•

用户下单后，抖音侧调用第三方创建旅行社日历套餐订单

•

支持支付前支付后

•

注意：如果第三方内部错误需要重试，错误码要传100

◦

旅行社直连概念定义与接口返回码汇总交易业务错误码定义

基本信息

Header

•

Content-Type：application/json

•

X-Bytedance-Logid: 请求 logid，用于问题排查用

•

x-life-clientkey: 服务商应用的 client_key

•

X-life-sign: 请求签名，签名规则

Body

接口出参
一级参数	名称	是否必填	参数类型	备注
order_id	抖音订单号	是	string
product_id	商品ID	是	string	抖音商品id
product_out_id	第三方商品ID	是	string
biz_type	日历商品	是	int	3021
item_count	购买份数	是	int	本期只有一份
create_order_unix	创建订单时间戳(秒）	是	int
pay_amount	订单支付金额	否	int	用户实际金额
pay_unix	订单支付时间戳秒	否	int	支付信息仅在支付后创单模式下在创单请求内才会携带
merchant_actual_amount	商家实收金额	是	int	用户支付+平台补贴
merchant_discount_amount	商家补贴金额	是	int	商家补贴
book_start_unix	出行开始日期	是	int	秒时间戳
book_end_unix	出行结束日期	是	int	秒时间戳
occupancies	出行人列表	否	list<struct>	除「无需填写」的情况，其余情况必传
-license_type	证件类型	否	int	详见旅行社直连接口返回码汇总中的附录
-license_id	证件ID，加密	否	string	如果选择了证件，则该证件ID必填
-name	中文姓名，加密	否	string	勾选证件时必传
-first_name	英文名，加密	否	string	勾选除身份证外的证件时必传
-last_name	英文姓，加密	否	string	勾选除身份证外的证件时必传
-license_validity	证件有效期	否	string	勾选除身份证外的证件时必传
-gender	性别	否	int	1.男 2女
-birthday	出生年月日	否	string	字段是否必填看商家在商品模版上的配置
contact_user	联系人信息	是	struct
-phone	手机号码，加密	是	string	需且仅需填写1个
-email	邮箱，加密	否	string
remark_from_guest	客人备注	否	string

json示例

{
  "order_id": "1019910188802905774",
  "product_id": "1791401504359467",
  "product_out_id": "987654321",
  "biz_type": 3021,
  "item_count": 1,
  "create_order_unix": 1708515793,
  "pay_amount": 10,
  "merchant_actual_amount": 10,
  "book_start_unix": 1708624920,
  "book_end_unix": 1708711320,
  "occupancies": [
    {
      "first_name": null,
      "last_name": null,
      "name": "张小奇",
      "license_type": 1,
      "license_id": "1················9",
      "license_validity": "2033-11-27",
      "gender": 1
    }
  ],
  "contact_user": {
    "first_name": null,
    "last_name": null,
    "phone": "157······08"
  }
}

响应参数

Body

接口出参
一级参数	二级参数	名称	是否必填	参数类型	备注
data
	order_out_id	第三方订单ID	否	string	创建成功的情况下该参数必传，否则会重试创单
	description	描述信息	否	string
	error_code	返回编码	是	int	错误码详见旅行社直连相关枚举中的（交易业务错误码定义）

json示例

{
    "data": {
        "order_out_id": "legends_1900",
        "description": "",
        "error_code": 0
    }
}