3.2.52 卡/券核销（强制验密）

### 3.2.52 卡/券核销
根据卡号或券号或动态码核销卡或者券。

**method:** allinpay.shopoint.couponService.couponConsumeV2
**version:** 1.0

**业务请求参数**

| 字段名 | 参数类型 | 必填 | 最大长度 | 说明 | 取值 |
| --- | --- | --- | --- | --- | --- |
| shopId | String | 否 |  | 店铺ID |  |
| shopCode | String | 否 |  | 店铺号 | 与shopId功能相同，shopId和shopCode同时输入则只取shopId，shopId和shopCode必输一项 |
| operUserId | String | 是 |  | 收银员id | 收银员登录名称 |
| orderId | String | 是 |  | 外部核券订单号 |  |
| couponConsumeList |  |  |  |  | 验卡/券列表 |
| orderId.couponNo | String | 是 |  | 卡号或券号或券动态码 |  |
| orderId.consumeAmount | String | 是 |  | 核销次数 | 计次卡（券）类单位为：次 |
| orderId.passwd | String | 否 |  | 密码,核销卡时与cidao至少填一项 | 券动态码及没密码时可为""加密传输（详见2.3.4） |
| orderId.cidao | String | 否 |  | 磁道信息, 核销卡时与passwd至少填一项 |  |
| orderId.principalAmt | Decimal | 否 |  | 本金 | 单位为元 |
| orderId.remark | String | 否 |  | 备注 |  |
| orderId.stlmShopList | List | 否 |  | 结算店铺信息 |  |
| orderId.stlmShopList[].stlmShopId | Integer | 否 |  | 结算店铺id |  |
| orderId.stlmShopList[].stlmShopCode | String | 否 |  | 结算店铺号 |  |
| orderId.stlmShopList[].stlmAmount | Decimal | 否 |  | 结算金额, 单位元 |  |

**业务响应参数**

| 字段名 | 参数类型 | 必填 | 最大长度 | 说明 | 取值 |
| --- | --- | --- | --- | --- | --- |
| code | Integer | 是 |  | 返回码 | 0-表示成功<br>3-表示失败，具体失败原因参见msg字段<br>其他：参见4.1 公共返回码 |
| msg | String | 是 |  | 错误信息 |  |
| data.orgName | String | 是 |  | 机构/商户名称 |  |
| data.tranNo | String | 是 |  | 交易流水号 |  |
| data.couponConsumeDetail | List | 是 |  | 验券交易详情 | 验券交易详情 |
| data.couponConsumeDetail[].couponNo | String | 是 |  | 券号 | 验券交易详情 |
| data.couponConsumeDetail[].financeList | List | 是 |  | 财务科目列表 |  |
| data.couponConsumeDetail[].financeList[].accountNo | String | 是 |  | 财务科目号 |  |
| data.couponConsumeDetail[].financeList[].accountTitle | String | 是 |  | 财务科目名称 |  |
| data.couponConsumeDetail[].financeList[].accountPriority | Integer | 是 |  | 财务科目优先级 |  |
| data.couponConsumeDetail[].financeList[].accountValue | BigDecimal | 是 |  | 科目值 | 科目值根据算法自动算出金额 |

**请求示例**

```json
{"shopId":"1","operUserId":"1","couponConsumeList":[{"couponNo":"10000000010000055943","consumeAmount":"1","remark":"哈哈"}]}
```

**响应示例**

```json
{
"code": 0 ,
"data": true ,
"sign":"VCpfqwnJGQvV5c3esmz5OpylgfIE6gGqtl3gS/Lrjz4dFt3icgeDA4yjZ9ZO+qJbGH85djwWp6EtTPPE/LRgI2TjWgiyuyR4FdJ7lM4ze/VwcAKxxWVj0OayjXLJblHxTtUNNjfzjH0ndnldQO7gigpvOfgMoampnbOq65SC+3o="
}
```