接口说明

如果用户抖音版本过低，无法使用前端 JSAPI 下单，开发者可用该接口替用户发起下单。

该接口发起的下单流程中不会有预下单回调。前端 JS API 下单与服务端 OpenAPI 下单的流程区别如下：

使用限制

预下单 OpenAPI 只针对低版本（低于抖音 19.7.0，基础库 20.43.0.3 版本）使用，我们会统计此类订单占比，如果发现违规使用，会进行惩处。当低版本减少后，会下掉该接口，请不要应用于其它场景，否则会影响业务。

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/apps/trade/v2/order/create_order/
HTTP Method	POST
Scope	industry_open.trade.order_create

请求参数

请求头

access-token必填String

示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

调用https://open.douyin.com/oauth/client_token/生成的token

content-type必填String

固定值"application/json"

Rpc-Transit-Life-AccountString

来客商户根账户ID

Body展开全部子属性

biz_lineInt32

业务线

consume_shop_infoStruct

自提店铺信息

展开子属性

contact_nameString

示例：张三

用户姓名，长度 <= 64 byte

cp_book_infoStruct

预约信息

门票类商品下单必传

展开子属性

cp_extraString

示例：xxx

开发者自定义透传字段，不支持二进制，长度 <= 2048 byt>

delivery_infoStruct

配送信息

展开子属性

discount_amountInt64

示例：20

开发者自定义透传字段，不支持二进制，长度 <= 2048 byt>

extraString

示例：xxx

下单备注信息，长度 <= 2048byt>

fee_listList

费用信息，包装费、配送费等

展开子属性

goods_listList

商品信息

goods_list 和 sku_list 二选一传入，不能都为空

展开子属性

limit_pay_way_listArray<Int64>

屏蔽的支付方式

open_idString

示例：ba253642-0590-40bc-9bdf-9a1334b94059

用户OpenId

order_entry_schemaStruct

订单详情页信息

展开子属性

out_order_noString

示例：13222

开发者的单号，长度 <= 64 byt>

pay_expire_secondsInt64

示例：500

支付超时时间，单位秒，例如 300 表示 300 秒后过期；不传或传 0 会使用默认值 300，最大不能超过48小时。

pay_notify_urlString

示例：https://xxxx

支付结果通知地址，必须是https类型。

若不填，默认使用在行业模板配置-消息通知的支付结果通知地址。

phone_numString

示例：13323345678

用户手机号，长度 <= 128 byte

price_calculation_detailStruct

营销算价结果信息

展开子属性

reserve_typeInt32

订单类型，实时单、预约单

sku_listList

商品sku信息

goods_list 和 sku_list 二选一传入，不能都为空

展开子属性

total_amountInt64

示例：100

订单总价，单位（分）

trade_optionString

示例：xxx

交易配置，由开发者指定

user_addressStruct

收货地址信息

展开子属性

请求示例
//商品库 good_list 下单
curl --location --request POST 'https://open.douyin.com/api/apps/trade/v2/create_order'\
--header 'Content-Type: application/json' \
--header 'access-token: clt.xxx' \
--data-raw='{
    "goods_list": [
        {
            "quantity": 1,
            "price": 100,
            "goods_title": "火锅团购",
            "goods_image": "https://xxx",
            "labels": "随时退|免预约",
            "goods_id": "goods_1",
            "goods_id_type": 2,
            "discount_amount": xxx,
            "date_rule": "周一至周日可用",
            "goods_page": {
                "path": "goods/infoxxxx",
                "params":"{\"id\":\"xxxxxx\"}"
            },
            "order_valid_time": {
                "valid_duration": 100000
            }，
            "goods_book_info": {
                "book_type": 2，
                "cancel_policy": 1
            },
            "merchant_uid":"商户号xxx"
        }
    ],
    "total_amount": 100,
    "discount_amount": 20,
    "app_id": "tt07e3715e98c9aac0",
    "phone_num": "19273654356",
    "contact_name": "张三",
    "extra": "xxx",
    "open_id": "xxx",
    "out_order_no": "132324",
    "pay_notify_url":"https://xxxx",
    "pay_expire_seconds": 500,
    "order_entry_schema": {
        "path":"pages/xxxindexxxx",
        "params":"{\"id\":\"xxxxxx\"}"
    },
    "cp_extra": "xxxxx",
    "price_calculation_detail": {
        "calculation_type": 1,
        "order_discount_detail": {
            "goods_total_discount_amount": 1,
            "marketing_detail_info": [
                {
                    "discount_amount": 10,
                    "discount_range": 1,
                    "id": "activity_id_xxxxxxx",
                    "note": "活动优惠",
                    "subtype": "商家侧子营销类型",
                    "title": "[活动] 满 10.00 减 7.00 元",
                    "type": 4
                },
                {
                    "discount_amount": 10,
                    "discount_range": 2,
                    "id": "coupon_id_xxxxxxx",
                    "note": "用券优惠",
                    "subtype": "商家侧子营销类型默认值",
                    "title": "[券] 减 0.01 元",
                    "type": 2
                }
            ],
            "order_total_discount_amount": 20
        },
        "goods_discount_detail": [
            {
                "goods_id": "goods_1",
                "marketing_detail_info": [
                    {
                        "discount_amount": 10,
                        "discount_range": 1,
                        "id": "activity_id_xxxxxxx",
                        "note": "活动优惠",
                        "subtype": "商家侧子营销类型默认值",
                        "title": "[活动] 满 10.00 减 7.00 元",
                        "type": 4
                    },
                    {
                        "discount_amount": 10,
                        "discount_range": 2,
                        "id": "coupon_id_xxxxxxx",
                        "note": "用券优惠",
                        "subtype": "商家侧子营销类型默认值",
                        "title": "[券] 减 0.01 元",
                        "type": 2
                    }
                ],
                "quantity": 1,
                "total_amount": 100,
                "total_discount_amount": 20
            }
        ],
        "item_discount_detail": [
            {
                "goods_id": "goods_1",
                "marketing_detail_info": [
                    {
                        "discount_amount": 10,
                        "discount_range": 1,
                        "id": "activity_id_xxxxxxx",
                        "note": "活动优惠",
                        "subtype": "商家侧子营销类型默认值",
                        "title": "[活动] 满 10.00 减 7.00 元",
                        "type": 4
                    },
                    {
                        "discount_amount": 10,
                        "discount_range": 2,
                        "id": "coupon_id_xxxxxxx",
                        "note": "用券优惠",
                        "subtype": "商家侧子营销类型默认值",
                        "title": "[券] 减 0.01 元",
                        "type": 2
                    }
                ],
                "total_amount": 100,
                "total_discount_amount": 20
            }
        ]
    }
}'
//商品库 SKU、商品库 Goods 下单

curl --location --request POST 'https://open.douyin.com/api/apps/trade/v2/create_order'\
--header 'Content-Type: application/json' \
--header 'access-token: clt.xxx' \
--data-raw='{
  "sku_list": [
    {
      "quantity": 2,
      "sku_id": "7128346098909300749",
      "sku_id_type": 1,
      "discount_amount": 0,
      "goods_info": {
        "date_rule": "周一至周日可用",
        "goods_id": "7128346098909300749",
        "goods_id_type": 1
      }
    }
  ],
  "total_amount": 480,
  "discount_amount": 0,
  "phone_num": "31",
  "contact_name": "且题化话",
  "extra": "nisi sit",
  "open_id": "xxxxxxx",
  "out_order_no": "27753r4e5rrr7fer43",
  "order_entry_schema": {
    "path": "2qerrw"
  }
}'
//非商品库 SKU、商品库 Goods 下单
curl --location --request POST 'https://open.douyin.com/api/apps/trade/v2/create_order'\
--header 'Content-Type: application/json' \
--header 'access-token: clt.xxx' \
--data-raw='{
  "sku_list": [
    {
      "quantity": 2,
      "sku_id": "7128346098909300749",
      "sku_id_type": 2,
      "price": 240,
      "discount_amount": 0,
      "goods_info": {
        "date_rule": "周一至周日可用",
        "goods_id": "7128346098909300749",
        "goods_id_type": 1
      }
    }
  ],
    "total_amount": 480,
    "discount_amount": 0,
    "phone_num": "31",
    "contact_name": "且题化话",
    "extra": "nisi sit",
    "open_id": "xxxxxxx",
    "out_order_no": "27753r4e5rrr7fer43",
    "order_entry_schema": {
        "path": "2qerrw"
    }
}'

响应参数

Body展开全部子属性

data必填Struct

返回数据信息

展开子属性

extra必填Struct

展开子属性

响应示例
正常响应示例异常响应示例
{
  "extra": {
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "202501091814036DD882345D93F750465B",
    "now": 1736417644
  },
  "data": {
    "pay_order_id": "xxx",
    "pay_order_token": "xxx",
    "open_book_info": {
      "book_id": "xxx"
    },
    "item_order_detail_list": [
      {
        "sku_id_type": 8403891929931775000,
        "item_order_id": "xxx",
        "price": 3833525997344889300,
        "goods_id": "goods_1",
        "goods_id_type": 2470230027172963300,
        "sku_id": "xxx"
      }
    ],
    "order_id": "xxx",
    "out_order_no": "xxx",
    "item_order_info_list": [
      {
        "item_order_id_list": [
          "X0LxxLmN64"
        ],
        "item_order_detail": [
          {
            "price": 4963843347107204000,
            "goods_id": "goods_1",
            "goods_id_type": 7199334937572044000,
            "sku_id": "xxx",
            "sku_id_type": 3697432851557826600,
            "item_order_id": "xxx"
          }
        ],
        "goods_id": "xxx",
        "sku_id": "xxx"
      }
    ],
    "error_code": 0,
    "description": ""
  }
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	2100001	未知错误	重试接口，重试3次仍报错联系抖音生活服务技术支持
200	2100004	系统繁忙，此时请开发者稍候再试	重试接口，重试3次仍报错联系抖音生活服务技术支持
200	2100005	参数不合法	更换参数
200	2119001	参数不合法	更换参数
200	2119002	系统繁忙，请稍候再试	重试
200	2119003	请求太过频繁，请稍后再试	重试
200	2119005	应用未获商家授权	联系合作商家在商家后台发起授权，并在服务商后台同意授权
200	2190002	access_token无效	调用接口重新生成access_token
200	2190004	应用未获得该能力, 请去https://open.douyin.com/申请	应用申请接口权限
200	2190008	access_token过期,请刷新或重新授权	规范token刷新机制，检查是否有测试环境在同步刷新token
200	3000001	根据实际业务错误返回	对照接口文档规范参数并重试
200	5000001	根据实际业务错误返回	联系抖音处理

请求示例补充

商品库 good_list 下单

curl --location --request POST 'https://open.douyin.com/api/apps/trade/v2/create_order'\--header 'Content-Type: application/json' \--header 'access-token: clt.xxx' \
--data-raw='{
    "goods_list": [
        {
            "quantity": 1,
            "price": 100,
            "goods_title": "火锅团购",
            "goods_image": "https://xxx",
            "labels": "随时退|免预约",
            "goods_id": "goods_1",
            "goods_id_type": 2,
            "discount_amount": xxx,
            "date_rule": "周一至周日可用",
            "goods_page": {
                "path": "goods/infoxxxx",
                "params":"{\"id\":\"xxxxxx\"}"
            },
            "order_valid_time": {
                "valid_duration": 100000
            }，
            "goods_book_info": {
                "book_type": 2，
                "cancel_policy": 1
            },
            "merchant_uid":"商户号xxx"
        }
    ],
    "total_amount": 100,
    "discount_amount": 20,
    "app_id": "tt07e3715e98c9aac0",
    "phone_num": "19273654356",
    "contact_name": "张三",
    "extra": "xxx",
    "open_id": "xxx",
    "out_order_no": "132324",
    "pay_notify_url":"https://xxxx",
    "pay_expire_seconds": 500,
    "order_entry_schema": {
        "path":"pages/xxxindexxxx",
        "params":"{\"id\":\"xxxxxx\"}"
    },
    "cp_extra": "xxxxx",
    "price_calculation_detail": {
        "calculation_type": 1,
        "order_discount_detail": {
            "goods_total_discount_amount": 1,
            "marketing_detail_info": [
                {
                    "discount_amount": 10,
                    "discount_range": 1,
                    "id": "activity_id_xxxxxxx",
                    "note": "活动优惠",
                    "subtype": "商家侧子营销类型",
                    "title": "[活动] 满 10.00 减 7.00 元",
                    "type": 4
                },
                {
                    "discount_amount": 10,
                    "discount_range": 2,
                    "id": "coupon_id_xxxxxxx",
                    "note": "用券优惠",
                    "subtype": "商家侧子营销类型默认值",
                    "title": "[券] 减 0.01 元",
                    "type": 2
                }
            ],
            "order_total_discount_amount": 20
        },
        "goods_discount_detail": [
            {
                "goods_id": "goods_1",
                "marketing_detail_info": [
                    {
                        "discount_amount": 10,
                        "discount_range": 1,
                        "id": "activity_id_xxxxxxx",
                        "note": "活动优惠",
                        "subtype": "商家侧子营销类型默认值",
                        "title": "[活动] 满 10.00 减 7.00 元",
                        "type": 4
                    },
                    {
                        "discount_amount": 10,
                        "discount_range": 2,
                        "id": "coupon_id_xxxxxxx",
                        "note": "用券优惠",
                        "subtype": "商家侧子营销类型默认值",
                        "title": "[券] 减 0.01 元",
                        "type": 2
                    }
                ],
                "quantity": 1,
                "total_amount": 100,
                "total_discount_amount": 20
            }
        ],
        "item_discount_detail": [
            {
                "goods_id": "goods_1",
                "marketing_detail_info": [
                    {
                        "discount_amount": 10,
                        "discount_range": 1,
                        "id": "activity_id_xxxxxxx",
                        "note": "活动优惠",
                        "subtype": "商家侧子营销类型默认值",
                        "title": "[活动] 满 10.00 减 7.00 元",
                        "type": 4
                    },
                    {
                        "discount_amount": 10,
                        "discount_range": 2,
                        "id": "coupon_id_xxxxxxx",
                        "note": "用券优惠",
                        "subtype": "商家侧子营销类型默认值",
                        "title": "[券] 减 0.01 元",
                        "type": 2
                    }
                ],
                "total_amount": 100,
                "total_discount_amount": 20
            }
        ]
    }
}'

商品库 SKU、商品库 Goods 下单

curl --location --request POST 'https://open.douyin.com/api/apps/trade/v2/create_order'\--header 'Content-Type: application/json' \--header 'access-token: clt.xxx' \
--data-raw='{
  "sku_list": [
    {
      "quantity": 2,
      "sku_id": "7128346098909300749",
      "sku_id_type": 1,
      "discount_amount": 0,
      "goods_info": {
        "date_rule": "周一至周日可用",
        "goods_id": "7128346098909300749",
        "goods_id_type": 1
      }
    }
  ],
  "total_amount": 480,
  "discount_amount": 0,
  "phone_num": "31",
  "contact_name": "且题化话",
  "extra": "nisi sit",
  "open_id": "xxxxxxx",
  "out_order_no": "27753r4e5rrr7fer43",
  "order_entry_schema": {
    "path": "2qerrw"
  }
}'

非商品库 SKU、商品库 Goods 下单

curl --location --request POST 'https://open.douyin.com/api/apps/trade/v2/create_order'\--header 'Content-Type: application/json' \--header 'access-token: clt.xxx' \
--data-raw='{
  "sku_list": [
    {
      "quantity": 2,
      "sku_id": "7128346098909300749",
      "sku_id_type": 2,
      "price": 240,
      "discount_amount": 0,
      "goods_info": {
        "date_rule": "周一至周日可用",
        "goods_id": "7128346098909300749",
        "goods_id_type": 1
      }
    }
  ],
    "total_amount": 480,
    "discount_amount": 0,
    "phone_num": "31",
    "contact_name": "且题化话",
    "extra": "nisi sit",
    "open_id": "xxxxxxx",
    "out_order_no": "27753r4e5rrr7fer43",
    "order_entry_schema": {
        "path": "2qerrw"
    }
}'

发起下单在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

请求示例补充

商品库 good_list 下单

商品库 SKU、商品库 Goods 下单

非商品库 SKU、商品库 Goods 下单

发起下单