用户校园卡面余额字段同步

---

校园卡余额信息同步由认证方提供接口，腾讯微卡根据需求定期拉取数据；

1. 请求方式

腾讯微卡采用POST的方式向认证方发送application/json请求。

2. 请求参数

腾讯微卡请求原始数据 R（即电子卡号/学工号组成的数组）：

{
    "cards": [
        "123456789",
        "234567891",
        ...
    ]
}

通过加密R可以得到R'：R' = AES_CBC_ENCRYPT(R) 。

{
    "raw_data":R',
    "app_key":APP_KEY
}

腾讯微卡会把加密后的数据以POST的方式发送到认证方提供的数据接口。

3. 数据返回

返回数据：

{
    "code":0,
    "message":"success",
    "raw_data":R',
    "app_key":APP_KEY
}

校方返回数据解密后示例：

[
    {
        "card_number": "123456789",
        "value": 192.01
    },
    {
        "card_number": "123456789",
        "value": 0
    },
    ...
]

其中: value即为显示在校园卡余额信息项上的内容

注意：

• 1，接口开发完后可以到腾讯微卡进行自助调试，地址：https://weixiao.qq.com/public/apiDebug/index.html ；
• 2，腾讯微卡保证请求校园卡余额字段数据的频率每秒不超过10次，每次不超过100张卡，校方须有相应的承载能力；

附件

1 数据加密

采用AES对称加密算法（AES/CBC/ZeroPadding 128位模式），具体算法见加解密demo。

KEY = APP_KEY
IV = APP_SECRET 前16位。

APP_KEY和APP_SECRET的获取见接口对接指引。