咖啡机万能码核销
1. 前言:
2. 交互时序图:
3. 请求场景:
咖啡机扫描动态卡(万能码)核销
万能码判断条件:二维码卡号以“lyf"开头,例如 :lyf$2a$10$orzrkMPRHDeurMdAqJWZkuspZFCqIKUcW8/gkvOFV9o9I5NAn4/g
4. 接口要求:
使用来伊份openapi加密协议进行加密请求
5. 接口标准
5.1 基本信息
描述 | 值 |
---|---|
服务名称 | community-card-api |
URL | 测试环境:https://openapi.test.laiyifen.com/community-card-api/community/dynamic/verification 生产环境:https://openapi.laiyifen.com/community-card-api/community/dynamic/verification |
认证方式 | 令牌 |
请求方式 | HTTP(POST) |
功能描述(适用场景) | 线下门店使用用户购买的次卡消费 |
5.2 请求头公共参数 (Header)
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
X-Co-Client | String | 是 | 客户端Id(来伊份提供) |
X-Co-Sign | String | 是 | 签名 |
X-Co-TimeStamp | String | 是 | 签名时间戳 |
5.3 入参 Body
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
skuCode | String | 是 | 商品编码 |
verificationCode | String | 是 | 核销码 |
verificationShop | String | 是 | 核销门店 |
5.4 入参示例
{
"skuCode": "107U",
"verificationCode":"lyf$2a$10$orzrkMPRHDeurMdAqJWZkuspZFCqIKUcW8/gkvOFV9o9I5NAn4/g",
"verificationShop": "11441"
}
5.5 返回统一参数
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
code | String | 是 | 返回请求业务代码 |
msg | String | 是 | 返回信息描述 |
data | Json | 是 | 返回参数 |
5.6 返回示例
{
"code": "500",
"msg": "核销失败"
}
{
"code": "200",
"msg": "核销成功"
}