查询订单信息
查询订单基本信息。
使用限制
无
接口说明
适用场景举例:查询异常订单的支付状态,确认订单是否交易成功。
基本信息
基本信息 | |
---|---|
HTTP URL | https://open.douyin.com/api/apps/trade/v2/order/query_order |
HTTP Method | POST |
Scope | industry_open.trade.order_common |
权限要求 | 不需要用户授权 |
请求头
参考通用参数
请求参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
---|---|---|---|---|
order_id | string | 否 | 抖音开放平台内部交易订单号,通过预下单回调传给开发者服务,长度 < 64byte | "mock_order_id" |
out_order_no | string | 否 | 开发者系统生成的订单号,与唯一order_id关联,长度 < 64byte | "mock_out_no" |
说明:
- order_id 与 out_order_no 二选一。
请求示例
curl --location --request POST 'https://open.douyin.com/api/apps/trade/v2/order/query_order' \ --header 'Content-Type: application/json' \ --header 'access-token: clt.xxx' \ --data-raw='{ "order_id" : "mock_order_id", "out_order_no" : "mock_out_order_no" }'
响应参数
名称 | 类型 | 描述 | 示例值 |
---|---|---|---|
data | object | 订单支付相关信息 | |
extra | object | 额外信息,参见通用参数 |
data 字段
名称 | 类型 | 描述 | 示例值 |
---|---|---|---|
order_id | string | 抖音开平侧订单号 | "mock_order_id" |
out_order_no | string | 开发者侧订单号,与 order_id 一一对应 | "mock_out_no" |
refund_amount | int64 | 已退款金额,单位分 | 10000 |
settle_amount | int64 | 已分账金额,单位分 | 0 |
total_fee | int64 | 订单实际支付金额,单位[分] | 10000 |
order_status | string | 订单支付状态
| "SUCCESS" |
pay_time | string | 支付时间,格式:2021-12-12 00:00:00 | "2021-12-12 00:00:00" |
pay_channel | int | 支付渠道枚举
| 1 |
channel_pay_id | string | 渠道支付单号,如微信的支付单号 | "2iu2082897r9hflquf" |
seller_uid | string | 卖家商户号 id | "287484783" |
item_id | string | 视频id | "9823789736" |
cp_extra | string | 预下单时开发者定义的透传信息 | "" |
message | string | 结果描述信息,如失败原因 | "SUCCESS" |
payment_order_id | string | 担保支付单 id | "abc123" |
delivery_type | int | 订单核销类型:
| 1 |
响应示例
正常示例
{ "data": { "order_id": "mock_order_id", "out_order_no": "mock_out_order_no", "refund_amount": 10000, "settle_amount": 0, "total_fee": 10000, "pay_time": "2021-12-12 00:00:00", "order_status": "SUCCESS", "pay_channel": 1, "channel_pay_id": "2iu208bfi2897r9hflquf", "seller_uid": "287484783", "item_id": "9823789736", "cp_extra": "", "message": "SUCCESS", "payment_order_id": "abc123" }, "extra": { "sub_error_code": 0, "sub_description": "success", "logid": "2022092115392201020812109511046", "now": 1663745962686, "error_code": 0, "description": "success" } }
异常示例
{ "data": { "error_code": 13000, "description": "系统错误" }, "extra": { "sub_error_code": 13000, "sub_description": "系统错误", "logid": "2022092115392201020812109511046", "now": 1663745962686, "error_code": 2191000, "description": "" } }
错误码
详情参见错误码/返回码 。