# 卡流水查询

# 接口地址

/marketing/card/bill/queryBySerialNumber

# 入参

# 字段说明

名称 类型 必填 示例 描述
serialNumber String "b8b5418a439f417fa9527015aaf53bfb" 流水号

# JSON示例

{
    "paramValues": [
        {
            "serialNumber": "b8b5418a439f417fa9527015aaf53bfb"
        }
    ]
}

# 出参

# 字段说明

名称 类型 示例 描述
serialNumber String "b8b5418a439f417fa9527015aaf53bfb" 流水号
idCardBill Number 10545360219000304622 卡单据唯一标识。
保证向后兼容,建议通过 detailList 字段获取相关明细。
balanceStatus String "7100" 卡单据结算状态。枚举值如下:
"7000"(未结算),"7100"(已结算)
保证向后兼容,建议通过 detailList 字段获取相关明细
idCardEntity Number 10545360219000304622 卡实体唯一标识。
保证向后兼容,建议通过 detailList 字段获取相关明细
usable Number 1 卡实体状态。枚举值如下:
0(已使用),1(可用),2(待开卡),3(已取消),4(已过期),5(已退卡),6(待激活)
保证向后兼容,建议通过 detailList 字段获取相关明细
detailList CardBillSerialNumberDetail[] 流水明细列表。单个操作时,列表长度为 1;批量操作时,列表长度大于 1
status Number 1 流水状态,枚举值如下:
1(成功)、0(处理中)、 -1(失败/部分失败)

# CardBillSerialNumberDetail

名称 类型 示例 描述
idCardBill Number 10545360219000304622 卡单据唯一标识。
balanceStatus String "7100" 卡单据结算状态。枚举值如下:
"7000"(未结算),"7100"(已结算)
idCardEntity Number 10545360219000304622 卡实体唯一标识。
usable Number 1 卡实体状态。枚举值如下:
0(已使用),1(可用),2(待开卡),3(已取消),4(已过期),5(已退卡),6(待激活)
idCardTemplate Number 16120760782169317473 卡模板唯一标识。

# JSON示例

{
  "code": 200,
  "message": "OK",
  "data": {
    "serialNumber": "b8b5418a439f417fa9527001aaf02abd",
    "idCardBill": "16179830385268498467",
    "balanceStatus": "7100",
    "idCardEntity": "16179830385016840227",
    "usable": 1,
    "status": 1,
    "detailList": [
      {
        "idCardBill": "16179830385268498467",
        "balanceStatus": "7100",
        "idCardEntity": "16179830385016840227",
        "usable": 1,
        "idCardTemplate": "16120760782169317473"
      },
      {
        "idCardBill": "16179830390100336666",
        "balanceStatus": "7100",
        "idCardEntity": "16179830389378916449",
        "usable": 1,
        "idCardTemplate": "16121506877690355766"
      },
      {
        "idCardBill": "16179830393921347606",
        "balanceStatus": "7100",
        "idCardEntity": "16179830393556443191",
        "usable": 1,
        "idCardTemplate": "16135527757428826135"
      },
      {
        "idCardBill": "16179830398778351688",
        "balanceStatus": "7100",
        "idCardEntity": "16179830398375698446",
        "usable": 1,
        "idCardTemplate": "16135527757428826135"
      }
    ]
  }
}