开发者发起下单

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

使用限制

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

接口说明

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

curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/trade/v2/order/create_order' \ --header 'access-token: clt.xxx' \ --header 'Content-Type: application/json' \ --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 } } ], "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" }'

{ "data": { "error_code": 0, "description": "success", "order_id": "ot7072366682238", "out_order_no": "121321432", "pay_order_id": "12423414234", "pay_order_token": "544352343", "item_order_info_list": [ { "item_order_id_list": [ "ot70939408076069" ], "goods_id": "700843652", "item_order_detail": [ { "item_order_id": "ot70939408076069", "price": 80 } ] } ] }, "extra": { "sub_error_code": 0, "sub_description": "success", "logid": "2022092115392201020812109511046", "now": 1663745962686, "error_code": 0, "description": "success" } }

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

access-token

string

必需

示例值:

clt.xxx

Body 参数application/json

goods_list

array [object {11}]

必需

商品信息，详情见开发者发起下单。

quantity

integer

商品数量

必需

price

integer

可选

商品价格，单位（分）注意：非 POI 商品必传

goods_title

string

可选

商品标题/商品名称，长度 <= 256 byte 注意：非 POI 商品必传

goods_image

string

可选

商品图片链接，长度 <= 512 byte 注意：非 POI 商品必传

labels

string

可选

商品标签，最多设置三个标签，例如：随时退｜免预约｜提前3日预约（“｜”是中文类型），详见 pay-button 支付的 type 的合法值部分，注意不是 good-type 的合法值。注意：非 POI 商品必传

goods_id

string

商品 id

必需

goods_id_type

integer

必需

商品 id 类别， POI 商品传 1 非 POI 商品传 2

date_rule

string

可选

使用规则，如 “周一至周日可用”、“周一至周五可用”、“非节假日可用”，默认“周一至周日可用”

goods_page

object

可选

order_valid_time

object

可选

goods_book_info

object

可选

total_amount

integer

订单总价，单位分

必需

discount_amount

integer

折扣金额，单位分

可选

app_id

string

必需

phone_num

string

可选

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

contact_name

string

可选

用户姓名，长度 <= 64 byte

extra

string

可选

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

open_id

string

用户 OpenID

必需

out_order_no

string

必需

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

pay_notify_url

string

可选

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

pay_expire_seconds

integer

可选

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

order_entry_schema

object

必需

订单详情页信息，详情见开发者发起下单。

path

string

必需

params

string

必需

cp_extra

string

可选

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

示例

返回响应

🟢200成功

application/json

Body

data

object

必需

error_code

integer

错误码，0为成功

必需

description

string

错误码描述

必需

order_id

string

必需

抖音开平侧生成的订单号

out_order_no

string

必需

开发者系统生成的订单号

pay_order_id

string

必需

调起收银台的支付订单号

pay_order_token

string

必需

调起收银台的 token

item_order_info_list

array [object {3}]

必需

extra

object

必需

sub_error_code

integer

必需

sub_description

string

必需

logid

string

必需

now

integer

必需

error_code

integer

必需

description

string

必需

err_no

string

必需

状态码 0，业务处理成功，具体错误码参见错误码/返回码

err_tips

string

错误提示信息

必需

🟠400请求有误

开发者发起下单

使用限制#

接口说明#

请求参数

返回响应

使用限制

接口说明