获取用户优惠信息
- APP刷脸支付，二维码主扫支付，智慧食堂开放平台需要调用该接口获取用户优惠信息。
- 发送POST请求，格式为 application/json
- 秘钥联系管理员在场景方案园区明细里取得
请求接口
- 园区配置的查询优惠地址
请求与响应参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| campusId | 是 | String | 园区ID |
| safeParams | 是 | String | 加密后参数 |
| sign | 是 | String | 签名，使用 园区秘钥 进行MD5摘要 |
safeParams解密
- 使用
AES/ECB/PKCS5Padding算法加解密
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| businessId | 是 | String | 商家Id |
| custId | 是 | String | 用户唯一标识，智慧食堂系统用户全局唯一编码 |
| outTradeNo | 否 | String | 商家订单号 |
| orderTime | 是 | String | 用户发起支付的时间， 如离线模式，为当时离线时发起支付的时间格式： yyyyMMddHHmmss |
| payAmount | 是 | Number | 原始金额 |
| vPosId | 是 | String | 虚拟柜台号 |
| custName | 是 | String | 用户名称 |
| offline | 否 | String | 0：联机支付，1：离线补扣默认没有传该字段，表示联机支付 |
响应参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| result | 是 | String | 结果标志，Y 表示成功，N 表示失败 |
| payAmount | 否 | Number | 原始金额 |
| actualAmount | 否 | Number | 实际支付金额 |
| accountNos | 否 | String | 用户可以使用的账户，多个NO以英文”,”分隔，如果用户没有可用的账户，该值为 空串如果不返回该参数，则按 照默认账户的扣款优先级进行 支付 |
| remark | 否 | String | 该用户支付折扣相关信息描述 |
| errCode | 否 | String | 错误代码，用于标识错误类型 |
| errMsg | 否 | String | 错误消息，提供错误详情 |
请求响应示例
{
"campusId": "campusId_181e3fba5c0e",
"safeParams": "safeParams_47d941d30198",
"sign": "sign_f905070128e3"
}
请求参数加密前示例
{
"businessId": "businessId_358ad50b7d4b",
"custId": "custId_5b81ddb3edb8",
"outTradeNo": "",
"orderTime": "20241029170906",
"payAmount": 1.00,
"vPosId": "vPosId_9b8498ce5f5f",
"custName": "custName_b6518dca380d"
}
响应参数加密前示例
{
"result": "Y",
"payAmount": 2.00,
"actualAmount": 1.00,
"accountNos": "",
"remark": "满2元减1元，上限1次",
"errCode": "errCode_91ded01516bf",
"errMsg": "errMsg_1ec60416b867"
}