查询劵状态信息

批量查询一个订单中的券的相关状态信息，比如已核销、已退款等状态。

使用限制

单次查询不能超过 20 个。

接口说明

如果在券码核销的流程中因为某种异常无法确认当前券码的核销状态，则可以通过这个接口查询券的相关状态信息。

只能传入同一个订单下的券列表，不能跨订单查询。

错误码

HTTP 状态码	错误码	描述	排查建议
200	10000	参数错误	参数不符合规范。请根据提示检查参数。
200	13000	系统错误，请重试	内部错误，重试可解决。
200	21047	商品单 id 不合法	检查 item_order_id 是否正确。

curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/trade/v2/query_item_order_info' \ --header 'Content-Type: application/json' \ --data-raw '{ "order_id": "ot123456", "item_order_id_list": [ "ot123", "ot456" ] }'

{ "err_no": 0, "err_tips": "success", "data": [ { "item_order_id": "item_order_id_example_1", "item_order_status": 1, "valid_start_time": 1642491214992, "valid_end_time": 1642491231992, "delivery_time": 1642493214992 }, { "item_order_id": "item_order_id_example_2", "item_order_status": 2, "valid_start_time": 1642491214992, "valid_end_time": 1623491214992, "delivery_time": 1642231214992 } ] }

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

order_id

string

必需

抖音开平内部交易订单号，通过预下单回调传给开发者服务，长度 < 64byte

item_order_id_list

array[string]

可选

交易系统订单号下的商品单号列表。最多支持 20 个商品单传入，超过将报错。

示例

返回响应

🟢200成功

application/json

Body

err_no

integer

必需

err_tips

string

必需

data

array [object {5}]

必需

item_order_id

string

交易系统商品单号

必需

item_order_status

integer

必需

商品单的状态： 0：无效值 1：待支付 2：待使用 3：已核销 4：订单关闭 10：待预约 20：退款中 21：已退款

valid_start_time

integer

必需

商品单的有效开始时间，毫秒级的 Unix 时间戳

valid_end_time

integer

必需

商品单的有效截止时间，毫秒级的 Unix 时间戳

delivery_time

integer

必需

商品单的核销时间，毫秒级的 Unix 时间戳

🟠400请求有误

查询劵状态信息

使用限制#

接口说明#

错误码#

请求参数

返回响应

使用限制

接口说明

错误码