Skip to main content

次卡核销

1. 前言：​

2. 交互时序图：​

3. 请求场景：​

智能设备扫描次卡二维码核销使用

4. 接口要求：​

使用来伊份openapi加密协议进行加密请求

5. 接口标准​

5.1 基本信息​

描述值
服务名称community-card-api
URL测试环境：https://openapi.test.laiyifen.com/community-card-api/community/card
生产环境：https://openapi.laiyifen.com/community-card-api/community/card
认证方式令牌
请求方式HTTP(POST)

5.2 请求头公共参数 （Header）​

参数名字参数类型是否必须说明
X-Co-ClientString是客户端Id（来伊份提供）
X-Co-SignString是签名
X-Co-TimeStampString是签名时间戳

5.3 入参 Body​

参数名字参数类型是否必须说明
cardNoString是卡号(扫码获取)
cardPwdString是密码(扫码获取)
shopCodeString是门店编码(来伊份提供)
mscCodeString是msc客户端编码(来伊份提供)
skuCodeString是商品编码(来伊份提供)
saleUnitCodeString是商品销售单位(来伊份提供)
skuQuantityBigdecimal是商品数量，默认1
uniqueCodeString是设备唯一编码，长度最大50
machineTypeString是设备类型（1:咖啡机）

5.4 入参示例​

{
    "cardNo":"77616DA6389BB3",
    "cardPwd":"7FC796CD36154C4",
    "shopCode":"107U",
    "mscCode":"107U_0006",
    "skuCode":"sw10",
    "saleUnitCode":"BEI",
    "skuQuantity":"1",
    "uniqueCode":"123134123123123123123123",
    "machineType":"1"
}

5.5 返回统一参数​

参数名字参数类型是否必须说明
codeString是返回请求业务代码
msgString是返回信息描述
dataJson是返回参数

5.6 返回参数Data​

参数名字参数类型是否必须说明
orderNoString是来伊份订单

5.7 返回示例​

{
    "code":"0",
    "msg":"success",
    "data":{
        "orderNo":"OR86768782123"
    }
}