腾讯微卡Wiki

# 小程序添加用户电子卡

小程序打开卡:wx.addCard (opens new window)，需要参数cardList,由本接口返回。

# 1.接口地址

# 请求方法：

GET(application/json)

# 请求地址：

https://weixiao.qq.com/apps/school-api/add-student-card

# 2.请求参数

{
    "wx_card_id": "WX_CARD_ID",
    "timestamp": "TIMESTAMP",
    "nonce": "NONCE",
    "app_key": "APP_KEY",
    "signature": "SINGATURE"
}
字段名 变量名 必填 示例值 类型 说明
微信电子卡标识 wx_card_id 是 pJBUeuIwvtYXgtiDPs9vZL12N-us String 电子卡生成时产生的唯一标识
时间戳 timestamp 是 1514276659 int 当前unix时间戳
随机串 nonce 是 5K8264ILTKCH16CQ2502SI8ZNMTM67VS String(32) 随机字符串
应用key app_key 是 SDFSDFD String(32) 腾讯微卡分配的app_key
签名 signature 是 a790e009d30c09bd8605810eaf9c44b0 String(32) 签名

签名方式：见签名算法 (opens new window)。

# 3.返回数据

# 响应说明：

json即为小程序所需要的开卡参数

{
    "code": 0,
    "message":'ok',
    "json": [
        {
        "cardId": '',
        "cardExt": '{"code": "", "openid": "", "timestamp": "", "signature":""}'
        }
    ]
}
参数 是否可空 说明
code 非空 返回码（0表示成功）
message 非空 提示信息
json 可空 小程序所需要的开卡参数
cardId 可空 小程序所需要的开卡参数
cardExt 可空 小程序所需要的开卡参数
code 可空 小程序所需要的开卡参数
openid 可空 小程序所需要的开卡参数
timestamp 可空 小程序所需要的开卡参数
signature 可空 小程序所需要的开卡参数

# 错误返回：

{
    "code": xxx,(非0错误码)
    "message": xxx,(错误信息)
}

# 4.错误码

名称 解决方案
10005 app_key权限不足
42007 该电子卡不存在
47001 主体不存在