开发
API

addOrder

addOrder

同步小程序订单,通过该接口实现订单的增加,可一次性添加多个订单(不超过 10 个)。

接口地址

POST https://developer.toutiao.com/api/apps/order/add

输入

以下参数均在 JSON body 中

名称必填默认值描述
access_token服务端 API 调用标识,获取方式
appname做订单展示的字节系 app 名称取值如下表所示
openid小程序用户 id
business_line字节系 app 授予小程序的业务线 id
order_list订单列表

order_list 字段

名称必填默认值描述
order_id订单 id
create_time订单创建的时间,10 位的 UNIX 时间戳
update_time订单状态更新的时间(这里指的是订单完成支付的时间),10 位的 UNIX 时间戳
status订单状态
amount订单商品总数,必须为整型字符串,例如"3"
total_price订单总价,必须为 Number 字符串,数字最多精确到小数点后两位(精确到分),例如"150.24"
detail_url订单详情页 url(目前只支持小程序侧地址,例如 pages/xxxx)
detail_url_backend订单详情页备用 url
item_list子订单商品列表

item_list 字段

名称必填默认值描述
item_code子订单 id
img子订单商品图片 url
title子订单商品介绍标题
sub_title子订单商品介绍副标题
amount单类商品的数目,必须为整型字符串,例如"2"
price单类商品的总价,必须为 Number 字符串,数字最多精确到小数点后两位(精确到分),例如"100.24"

appname 的取值

appname对应字节系 app
douyin抖音

⚠️ 注意

小程序需线下提供业务名称和图标,向小程序开放平台获取 business_line。

7 月 31 日之后开通了支付能力的小程序已后台自动分配 business_line,该字段无需再传输。

输出

返回值为 JSON 形式,返回信息如下

名称数据类型属性
errcodenumber错误号
errmsgstring错误信息

具体对应关系为

错误号描述
0请求成功
-1系统错误
40002access_token 错误
40003openid 错误
40014http 参数错误
40016appname 错误
40022business_line 错误
60004订单已存在
60007订单个数超出限制
其它其它参数错误

示例

body 示例如下

{
    "access_token": "accfggdggxx",
    "openid": "dsfasgagagahadhaxxx",
    "appname": "douyin",
    "business_line": 8,
    "order_list": [
        {
            "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
            "create_time": 1527584231,
            "update_time": 1527584244,
            "status": "已完成",
            "amount": "2",
            "total_price": "2410.20",
            "detail_url": "pages/orders/pay/pay?order_id=3367",
            "detail_url_backend": "pages/orders/pay/pay?order_id=3367",
            "item_list":[
                {
                    "item_code": "00003563372839_00000010001xxx",
                    "img": "https://image.tt.com/?z=0&word=%E4%BE%AF",
                    "title": "按摩椅",
                    "sub_title": "来自北欧宜家的按摩椅",
                    "amount": "2",
                    "price": "2410.20"
                }
            ]
        }
    ]
}

其他

小程序抖音订单常见问题

点击纠错
评价此篇文档