接口说明

服务商通过接口查询订单详情，支持三种查询方式：

（1）根据订单 id ，查询对应订单详情，入参：订单 id；

（2）根据订单状态和商户 id，查询指定时间内该商户下的订单列表，入参：商家id、订单状态、创单起止时间/修改起止时间；

（3）根据用户 id 和商户 id，查询某用户在该商户下的所有订单，入参：商家id、用户 id、创单起止时间/修改起止时间；

支付后未发码/发码失败订单查询方式：限定订单状态为“已支付”，如用户下单后超过 10 分钟未发码会发起退款；
退款申请待审核订单查询方式：限定券状态为“退款中”，如退款状态未响应超过 72 小时会自动退款。
金额计算公式：
原始金额 - 折扣金额（优惠金额） = 实付金额 original_amount - discount_amount = pay_amount
原始金额 = 各子单原始金额之和（子单包含商品、配送费等）

基本信息

名称	描述
HTTP URL	https://open.douyin.com/goodlife/v1/hermes/trade/order/query/
HTTP Method	GET
Scope	life.capacity.order.query
权限要求	订单查询

请求参数

请求头

access-token必填String

示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

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

content-type必填String

固定值"application/json"

Rpc-Transit-Life-AccountString

来客商户根账户ID

Query

account_id必填String

商家ID

create_order_end_timeInt64

创单结束时间秒时间戳

create_order_start_timeInt64

创单起始时间秒时间戳

ext_order_idString

外部订单id

get_secret_numberBool

是否需要获取隐私号

open_idString

抖音用户id

order_idString

订单ID

order_statusInt32

订单状态

page_numInt32

页数默认1

page_sizeInt32

页面大小默认10 最大200

update_order_end_timeInt64

修改起始时间秒时间戳

update_order_start_timeInt64

修改起始时间秒时间戳

请求示例
curl --location --request GET 'https://open.douyin.com/goodlife/v1/hermes/trade/order/query/?update_order_start_time=2987601906272435604&get_secret_number=false&order_id=Wi2ROMyXUS&order_status=721122388193841376&create_order_start_time=7490058674000512431&page_size=339860474914029302&page_num=8171535757830193818&account_id=YmAQx7Pxef&update_order_end_time=1088891114456186528&open_id=iLquSHEKFk&ext_order_id=BYi9sFqRt3&create_order_end_time=8868378504697685663' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6' \

响应参数

Body展开全部子属性

extra必填Struct

扩展信息

展开子属性

dataStruct

业务数据

展开子属性

响应示例
正常响应示例异常响应示例
{
  "extra": {
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "20250122172130FE52BA6ADA445DE9E148",
    "now": 1737537691
  },
  "data": {
    "orders": [
      {
        "poi_id": "jY811CebXL",
        "buyer_info": {
          "buyer_secret_number": "pAbNQ7bpsD",
          "buyer_real_phone": "543zfPrDnY",
          "buyer_phone": "S3HgsJYhEF"
        },
        "sku_id": "QHvWE1vKdl",
        "delivery_info": {
          "table_ware": "0DM6bnAuAd",
          "deliver_model": 7343648902987290000,
          "shop_number": "DJwTsr1AnA",
          "is_book": false,
          "user_expect_time": "lHBWwbMyLy",
          "sys_expect_time": "wML1fhi3Q1",
          "remark": "KeCwhk86wv"
        },
        "original_amount": 4329321676916643300,
        "sku_type_num": 6711202695876029000,
        "amount_info": {
          "packing_price": 1609671072861343500,
          "product_origin_amount": 1997979068599128000,
          "platform_discount_amount": 2443191636995071000,
          "discounts": [
            {
              "discount_amount": 6079640024274783000,
              "merchant_discount_amount": 37537945531756880,
              "platform_discount_amount": 4641049498593178000,
              "discount_type": 3034843038722568700
            }
          ],
          "sale_price": 8809761539445192000,
          "commission_amount": 8726101247793499000,
          "activities_fee_amount": 6216244115278889000,
          "merchant_deliver_freight_fee": 3862775485294776300,
          "freight_pay_amount": 4025159472180504000,
          "other_fee_amount": 7522801020400101000,
          "pay_discount_amount": 7937855621806103000,
          "estimated_order_income": 6306455375617312000,
          "platform_deliver_freight_fee": 9054144773417341000,
          "freight_actual_pay_amount": 5484890823867903000,
          "origin_amount": 807713065243753100,
          "discount_amount": 607212972697672300,
          "merchant_discount_amount": 3740723544989605400,
          "pay_amount": 6425730508250934000
        },
        "order_type": 2959844142967234600,
        "certificate": [
          {
            "item_update_time": 2143342828205755000,
            "refund_amount": 4781498634328195000,
            "refund_time": 1282285690182914800,
            "order_item_id": "swxpLiMRNV",
            "certificate_id": "quTCnq2ONe",
            "item_status": 4326382503842790400
          }
        ],
        "order_id": "sOACA9Wocf",
        "create_order_time": 3177216034044884000,
        "discounts": [
          {
            "platform_discount_amount": 3859066712834403000,
            "discount_type": 7288780751132884000,
            "discount_amount": 7222124814161127000,
            "merchant_discount_amount": 8040757696753665000
          }
        ],
        "third_sku_id": "OC84jMkKvI",
        "refund_infos": [
          {
            "products_refund": [
              {
                "product_origin_amount": 1375133646704220000,
                "commodities": [
                  {
                    "item_list": [
                      {
                        "desc": "oOdRGsSupG",
                        "name": "NAreHNHXQd",
                        "original_price": 4569465689569925000,
                        "ingredients": [
                          {
                            "out_id": "seQcuVTYfb",
                            "product_id": "TyK65MNQ00",
                            "name": "jcUnbLm7jW",
                            "count": 8457583896651829000
                          }
                        ],
                        "price": 5674660900008459000,
                        "attr_list": [
                          "bOg3uGBJjy"
                        ],
                        "original_sku_id": "fNIjP566ZQ",
                        "specs": [
                          {
                            "name": "QyPCpe2OwT",
                            "value": "vHoQ1Lv51v",
                            "sku_id": "CftSvM1boA",
                            "out_sku_id": "qKxjM573SS",
                            "value_type": 2460572379474857000,
                            "value_metric": "E8oaLETevu"
                          }
                        ],
                        "sku_attr_list": [
                          {
                            "upgrade_price": 5323151943388818000,
                            "attr_name": "Let8X6s5vd",
                            "num": 3763956099188241000,
                            "product_id": "TsDFlZkVmT",
                            "out_id": "PZz6AvhzR8"
                          }
                        ],
                        "unit": "aU4YZzsgqN",
                        "product_id": "2VC9edEzio",
                        "out_id": "Uu5Kn61JrY",
                        "item_tag": "5scyL6qCkV",
                        "sku_id": "K6VRD6qsrH",
                        "original_out_sku_id": "7ZjBaaXNCd",
                        "count": 5748686376940782000,
                        "attributes": [
                          {
                            "name": "fnY8sxD0KJ",
                            "value": "UKVsZ9smPp"
                          }
                        ],
                        "deduction_info_list": [
                          {
                            "certificate_id": 2531634865714934000,
                            "amount": 2650058682043934000,
                            "third_part_code": "RzIN4izQTw"
                          }
                        ],
                        "out_sku_id": "0Vc3ban3pd"
                      }
                    ],
                    "group_name": "4BgNm4NZaC",
                    "total_count": 5555179728482722000,
                    "option_count": 6812369221162691000
                  }
                ],
                "origin_amount": 7394945094651963000,
                "specs": [
                  {
                    "sku_id": "VxgWARlutU",
                    "out_sku_id": "AtKMO5LIHp",
                    "value_type": 960015261145640800,
                    "value_metric": "KHPNEUVBBn",
                    "name": "muDHSAtYTo",
                    "value": "GNquIWVxK6"
                  }
                ],
                "out_id": "UtUfAXymkx",
                "num": 8368574218757084000,
                "ingredients": [
                  {
                    "count": 6105174957327359000,
                    "out_id": "LlytmPhWBo",
                    "product_id": "YhrBDo9IgZ",
                    "name": "e5b3bp1OWM"
                  }
                ],
                "attributes": [
                  {
                    "value": "HvyvoSsshI",
                    "name": "xfjuCdUCRq"
                  }
                ],
                "product_id": "4eKvsYS82c",
                "snapshot_product": {
                  "product_attr": {
                    "voucher_par_type": 1,
                    "dynamic_par_rule": {
                      "dynamic_par_rule_desc": "QTvOWPwc2o",
                      "dynamic_par_min_amount": 5245586131155786000,
                      "dynamic_par_max_amount": 6862677469497581000,
                      "dynamic_par_rule_item_list": [
                        {
                          "deductible_amount": 7520818100255014000,
                          "day_of_week": [
                            1
                          ],
                          "time_period": {
                            "use_end_time": "eHL8Ier1sm",
                            "end_time_is_next_day": false,
                            "use_start_time": "vLipbodzBC"
                          }
                        }
                      ]
                    }
                  }
                },
                "product_name": "GmULfF4eKy",
                "product_type": 4182096246506074600,
                "sku_id": "cLbLPoqYVE"
              }
            ],
            "after_sale_id": "rC83S4wgg5",
            "refund_complete_time": 1721548715649558800,
            "user_refund_amount": 6569753555708572000
          }
        ],
        "total_sku_type_num": 5008031813040646000,
        "sku_name": "etNuX9VLWF",
        "order_status": 8739294785154971000,
        "payment_discount": 5451225751020130000,
        "pay_time": 8654461314577481000,
        "count": 8008286414485234000,
        "is_deliver_later": false,
        "is_multi_order": false,
        "total_sku_num": 2921866513556456400,
        "sku_num": 4061853709503625000,
        "pay_amount": 2818929916541657600,
        "dish_sku_num": 3794634678346475000,
        "dish_sku_type_num": 1005944041390625700,
        "receiver_info": {
          "location_address": "h8PtI6yxvu",
          "lat": 0.18019369953437264,
          "lng": 0.16386190785621366,
          "receiver_name": "fX2AgiVUy6",
          "province": "drHRwmuSe6",
          "receiver_real_phone": "yEVqNMVpRv",
          "receiver_phone": "z1x6FwzXjY",
          "city": "7mPZJqhFYi",
          "location_name": "tk37gnwgRF",
          "door_plate_num": "J8n3GUpeSB",
          "secret_number": "PJZJSmVNVc",
          "district": "o7v4mrixPo",
          "town": "FQvEIANxEB"
        },
        "poi": {
          "poi_id": "az0LMt0fXg",
          "poi_name": "CpRIGKi6fV"
        },
        "products": [
          {
            "ingredients": [
              {
                "product_id": "php9enxGWk",
                "name": "APm0stMlqh",
                "count": 5948222199234260000,
                "out_id": "F2iakpc6Ht"
              }
            ],
            "specs": [
              {
                "value": "tU6kMpPXb4",
                "sku_id": "ojrrboeybs",
                "out_sku_id": "fvut71E2Kr",
                "value_type": 8471769126273787000,
                "value_metric": "3U7p8DujJe",
                "name": "dYcR2mJ0eS"
              }
            ],
            "attributes": [
              {
                "name": "z7KEmcSrl5",
                "value": "mYYqLdncJL"
              }
            ],
            "num": 4797315780943863000,
            "product_name": "dMNtxJwNzi",
            "product_type": 2802733335367536000,
            "product_origin_amount": 228904071778549300,
            "origin_amount": 6719086291472432000,
            "sku_id": "nORGQ2X493",
            "product_id": "Qhf7ehSqjE",
            "snapshot_product": {
              "product_attr": {
                "voucher_par_type": 1,
                "dynamic_par_rule": {
                  "dynamic_par_max_amount": 3977056120831239700,
                  "dynamic_par_rule_item_list": [
                    {
                      "day_of_week": [
                        1
                      ],
                      "time_period": {
                        "use_start_time": "vd8BsaYq5a",
                        "use_end_time": "4ahIHnox2Y",
                        "end_time_is_next_day": false
                      },
                      "deductible_amount": 5724810305747098000
                    }
                  ],
                  "dynamic_par_rule_desc": "bw3uAXdq2a",
                  "dynamic_par_min_amount": 3528983776294879700
                }
              }
            },
            "out_id": "NzCNmD3YAg",
            "commodities": [
              {
                "group_name": "PrRHJvLYnQ",
                "total_count": 1313628979704465400,
                "option_count": 6555852845809366000,
                "item_list": [
                  {
                    "ingredients": [
                      {
                        "name": "qTP62lshin",
                        "count": 3139845497232305000,
                        "out_id": "QThH2J9noL",
                        "product_id": "Yr68JtmpnR"
                      }
                    ],
                    "product_id": "edj6Qe2ekP",
                    "item_tag": "KTmW2xoh6o",
                    "original_price": 3100368641338305500,
                    "unit": "b1uJPH9cO2",
                    "attr_list": [
                      "FbT96NlMz9"
                    ],
                    "name": "Il3m4g46W9",
                    "sku_attr_list": [
                      {
                        "attr_name": "ntshvgOb7k",
                        "num": 8741718766086267000,
                        "product_id": "DvgU2IFGuU",
                        "out_id": "TCRp5l40A6",
                        "upgrade_price": 5055302891011639000
                      }
                    ],
                    "count": 1797964288062405000,
                    "deduction_info_list": [
                      {
                        "certificate_id": 3217466290983384600,
                        "amount": 3211152737582305300,
                        "third_part_code": "sVrxe1GuLs"
                      }
                    ],
                    "original_out_sku_id": "FQFtuzpaUj",
                    "desc": "3Ali0TOMRO",
                    "sku_id": "D8F2oQDKUX",
                    "out_id": "YIKInni7Zr",
                    "out_sku_id": "YS9Krc3aSD",
                    "attributes": [
                      {
                        "value": "tGnd8Yx56Q",
                        "name": "bSzqjKRIHs"
                      }
                    ],
                    "price": 8434292191711399000,
                    "original_sku_id": "MdUKOqPtrH",
                    "specs": [
                      {
                        "name": "PN0GqqM38i",
                        "value": "aSdGUuvR3G",
                        "sku_id": "ipqGwuui4X",
                        "out_sku_id": "BDF5vENh5h",
                        "value_type": 8106255903781180000,
                        "value_metric": "1KyMuneEOS"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ],
        "sub_order_amount_infos": [
          {
            "origin_amount": 4839907269699027000,
            "discount_amount": 4576643710943936500,
            "discounts": [
              {
                "merchant_discount_amount": 5298513552615637000,
                "platform_discount_amount": 2922686998104331000,
                "discount_type": 7083823956591271000,
                "discount_amount": 4360035634222093000
              }
            ],
            "sub_order_type": 3162786345160111600,
            "sub_order_id": "tzumj4UySW",
            "pay_amount": 3568286864516173000
          }
        ],
        "products_after_refund": [
          {
            "product_origin_amount": 2909032606274113000,
            "snapshot_product": {
              "product_attr": {
                "dynamic_par_rule": {
                  "dynamic_par_min_amount": 6421958116736292000,
                  "dynamic_par_max_amount": 8412979170843304000,
                  "dynamic_par_rule_item_list": [
                    {
                      "day_of_week": [
                        1
                      ],
                      "time_period": {
                        "use_start_time": "xcWH95iwxB",
                        "use_end_time": "00vMs10Xzu",
                        "end_time_is_next_day": false
                      },
                      "deductible_amount": 197531858472563520
                    }
                  ],
                  "dynamic_par_rule_desc": "jCyu3VvFMv"
                },
                "voucher_par_type": 1
              }
            },
            "commodities": [
              {
                "group_name": "UnUbHsTdUB",
                "total_count": 937250972481723400,
                "option_count": 6373993137480654000,
                "item_list": [
                  {
                    "count": 7828611274856566000,
                    "price": 3343073175415609300,
                    "attr_list": [
                      "C7kx2evFUO"
                    ],
                    "unit": "mnNXqtD2KZ",
                    "product_id": "3W02Uq2HSW",
                    "desc": "PR0gXDAuiv",
                    "out_sku_id": "FtIvxSFtfw",
                    "original_sku_id": "8cl9xemJXR",
                    "deduction_info_list": [
                      {
                        "third_part_code": "buKNcaGeHd",
                        "certificate_id": 886646910748332800,
                        "amount": 2937143290198479000
                      }
                    ],
                    "item_tag": "fOE3wrSQF9",
                    "sku_attr_list": [
                      {
                        "out_id": "1PnCrCXQom",
                        "upgrade_price": 6766610373655941000,
                        "attr_name": "woVwQReHsY",
                        "num": 383385116946876600,
                        "product_id": "5Mguh75JBR"
                      }
                    ],
                    "specs": [
                      {
                        "value": "sqWMO9P8ai",
                        "sku_id": "jAJod7PCHt",
                        "out_sku_id": "qEDFrKVnk9",
                        "value_type": 5873841625378300000,
                        "value_metric": "6a0KfxWAcI",
                        "name": "6phBO3L62Z"
                      }
                    ],
                    "ingredients": [
                      {
                        "count": 6672946003985132000,
                        "out_id": "w7B84N4DLx",
                        "product_id": "x2fXw9EeZg",
                        "name": "IiynJbDUks"
                      }
                    ],
                    "attributes": [
                      {
                        "name": "SLv0Qigjpv",
                        "value": "bwVFHKQZh2"
                      }
                    ],
                    "sku_id": "oL43eEiJyY",
                    "out_id": "Rg9TLi8ZPZ",
                    "name": "PjedyIIDSq",
                    "original_price": 2452419226791278600,
                    "original_out_sku_id": "zTQeGvyXqd"
                  }
                ]
              }
            ],
            "origin_amount": 4796291586697857000,
            "attributes": [
              {
                "value": "yVz8rv4lXh",
                "name": "1pMFdjvCNO"
              }
            ],
            "ingredients": [
              {
                "count": 4431817588192863700,
                "out_id": "7jgzOZwmRb",
                "product_id": "HgwGR1HUoQ",
                "name": "jqybMjJZoI"
              }
            ],
            "product_name": "RCT8rDiQtV",
            "specs": [
              {
                "name": "xIUlflivKG",
                "value": "CrKnP2Xy26",
                "sku_id": "g0lmaNVplB",
                "out_sku_id": "HrcJzNJxxl",
                "value_type": 957392388144627000,
                "value_metric": "4KrQX73WYE"
              }
            ],
            "product_id": "89kWY29fYP",
            "num": 3487313684981550600,
            "product_type": 4146698338340627000,
            "sku_id": "AuVkBTEEXM",
            "out_id": "j2a5pCIjB1"
          }
        ],
        "merchant_info": {
          "account_name": "FfixNFHvtX",
          "account_id": "eV0KIDmolF"
        },
        "update_order_time": 5205506046417324000,
        "discount_amount": 6617520400392805000,
        "open_id": "Lgye3RXn5J",
        "contacts": [
          {
            "name": "VFoWSIlEQj",
            "phone": "jKqifjPDLO",
            "phone_encrypt": "dzh78cQuij"
          }
        ],
        "user_id": 7411676186906729000
      }
    ],
    "page": {
      "page_num": 4003653614034698000,
      "page_size": 8660089695909990000,
      "total": 7738418507022006000
    },
    "error_code": 0,
    "description": ""
  }
}

切换单列布局

错误码

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

订单查询在线调试

接口说明

基本信息

请求参数

响应参数

错误码

订单查询