POST/card/queryOrderCardList管理后台

根据订单ID查询 - 旅游卡信息

旅游卡 / 卡（主表）· CardController#queryOrderCardList

基本信息

接口状态前端在用置信度高
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/card/queryOrderCardList
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 管理后台（1 个前端）
需求上下文1订单回调处理BUG修复
维护人 / 最后改动luoli　2024-03-04　最近提交：1订单回调处理BUG修复
读写数据表card、order_goods、openapi_channel_card　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.card.CardController#queryOrderCardList
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/card/CardController.java:1049
判定依据1 个调用点：dscp-html-manage/src/api/card/index.ts

请求参数

Header 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无（渠道统一鉴权头见《认证方式》）

Query 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无

路径参数及说明

参数名	参数值	是否必填	参数类型	描述说明
无

Body 请求参数

Body 类型 OrderCardRequest

参数名	参数值	是否必填	参数类型	描述说明
orderId	…	否	Long	支付状态，1=待支付 2=已支付 3=已退款 → order_goods.order_id

认证方式

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

响应参数

data 类型 List<OrderCardListResponse>

参数名	参数值	是否必填	参数类型	描述说明
goodsName	…	否	String	商品名称 → order_goods.goods_name
skuName	…	否	String	SKU名称
orderStatus	…	否	OrderStatus	订单状态 1＝待支付 2＝待发货 3＝已发货 4＝已完成 5＝已取消 6＝退款中 7＝已退款
cardNumber	…	否	String	卡号 → card.card_number
createdTime	…	否	Date	发卡时间 → order_goods.created_time
cardState	…	否	CardState	卡状态 1＝待销售 2＝待激活 3＝已激活 4＝已绑定 5＝已禁用 6＝已过期 7＝已无效 8＝已锁定

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "goodsName": "\"string\"",
    "skuName": "\"string\"",
    "orderStatus": "1",
    "cardNumber": "\"string\"",
    "createdTime": "\"2026-01-01 00:00:00\"",
    "cardState": "1"
  }
}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：card、order_goods、openapi_channel_card　反查全部引用接口 →

CardController#queryOrderCardList
CardService#queryList（CardServiceImpl）
CardMapper#queryList
OrderService#mustGet（OrderServiceImpl）
OrderMapper#mustGet
OrderGoodsService#mustGet（OrderGoodsServiceImpl）
OrderGoodsMapper#mustGet
OpenapiChannelCardService#queryList（OpenapiChannelCardServiceImpl）
OpenapiChannelCardMapper#queryList
CardService#mustGet（CardServiceImpl）
CardMapper#mustGet
BeanUtils.mapList → OrderCardListResponse

其它依赖：OrderService.mustGet、OrderGoodsService.mustGet、CardService.mustGet

逻辑摘要：列表查询（cardService.queryList）；调用 mustGet（orderService.mustGet）；调用 mustGet（orderGoodsService.mustGet）；入参与返回值经 BeanUtils 做对象/分页映射

源码内联注释（旧站解析结果）

根据订单查询卡信息
查询订单信息
查询订单商品信息
如果根据订单id无法查询到卡信息，则表示属于订单购买的是其他渠道的卡
非数字化平台卡订单信息列表
订单状态

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据

dscp-html-manage/src/api/card/index.ts:227　管理后台 · request