查询券码
描述
查询订单生成的券码。
路径
/optimus/core/voucher/queryOrderVoucherList
入参说明(JSON 格式)
入参整体结构
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| appid | 应用id | String | Y | 固定值 | 见测试参数 |
| seller | 卖家信息 | Object | Y | 固定值 | 见测试参数 |
| orderID | 订单信息 | Object | Y | 前置操作后拿到 |
入参字段结构
seller 字段明细
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| merchantId | 商户Id | String | Y | 固定值 | 见测试参数 |
| merchantUserId | 商户userId | String | Y | 固定值 | 见测试参数 |
| role | 角色 | String | Y | 固定值 | 见测试参数 |
orderID 字段明细
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 |
|---|---|---|---|---|
| sn | 订单编号 | String | Y | 前置操作后拿到 |
| signature | 订单密码 | String | Y | 前置操作后拿到 |
出参说明(JSON 格式)
出参整体结构
| 参数 | 参数名称 | 类型 | 描述 | 示例 |
|---|---|---|---|---|
| success | 请求状态 | Boolean | true:成功;false:失败 | TRUE |
| code | 状态码 | String | 0000:成功;其他为异常码 | "0000" |
| msg | 状态描述 | String | 请求结果的描述信息 | "处理成功" |
| data | 订单数据 | List\ | 结果数据 |
出参字段结构
data 字段明细
| 参数 | 参数名称 | 类型 | 描述 |
|---|---|---|---|
| voucherName | 券名称 | String | |
| spuId | 商品spu | String | |
| skuId | 商品sku | String | |
| itemImageUrl | 商品地址 | String | |
| url | 券二维码 | String | |
| voucherNo | 券号 | String | |
| type | 券类型 | Byte | 0 金额券 1 商品券 |
| status | 券使用状态 | Byte | 0 未核销 1 已核销 2 未核销退款 3 已核销退款中 4 未核销退款完成 5 已核销退款完成 6 已失效 |
| operationTime | 操作时间 | String |
示例
{
"appid": "2025082700005615",
"seller": {
"merchantId": "1c904b2d-f056-4afa-a819-0328a4774320",
"merchantUserId": "6ce169d1-1289-4e98-b4a3-ea8b6145046f",
"role": "super_admin"
},
"orderID": {
"sn": "7274425403705112",
"signature": "c-T5kPjLxxdmYicfNXKj"
}
}