腾讯微卡Wiki

# 充值

# 接口说明

# 接口地址

https://open.wecard.qq.com/cgi-bin/pay/provider/recharge/increase

# 请求方法

POST

# 请求参数

access_token=[鉴权token]

参数 是否必填 类型 实例 说明
access_token 是 String 应用有效凭证

# 请求body（json）

{"org_code":"1010343033","user_id":"1762015xxxx","user_name":"uvQlxK4ByVTW/jEmpuhzvp+Qdndg+Q==","amount":1000,"nonce":"eJMavCwXdP2K","associate_data":"increase"}
参数 是否必填 类型 实例 说明
billno 是 String 账单号，充值唯一标识；需唯一，可为应用方的充值记录主键ID
org_code 是 String 主体code
user_id 是 String 用户id
user_name 是 String 用户姓名（需要对称加密再进行Base64转换）
amount 是 Integer 充值金额（分）
nonce 是 String 随机字符串（加密需使用）
associate_data 是 String 固定传 increase（加密需使用）

# 响应说明

{
    "code": 0,
    "data": {
        "balance": 23835
    },
    "message": "成功"
}
参数名 类型 必填 描述
code int 是 0为成功，非0为失败
data.balance int 否 充值后账户余额（分）; code为0时返回
message string 是 接口响应说明

# 核减

# 接口说明

# 接口地址

https://open.wecard.qq.com/cgi-bin/pay/provider/recharge/reduce

# 请求方法

POST

# 请求参数

access_token=[鉴权token]

参数 是否必填 类型 实例 说明
access_token 是 String 应用有效凭证

# 请求body（json）

{"org_code":"1010343033","user_id":"1762015xxxx","user_name":"CGdPee2LUkDD+BOJqmbc6irdtmR9og==","amount":10,"nonce":"1p6O0l7iJqgW","associate_data":"increase","task_id":""}
参数 是否必填 类型 实例 说明
org_code 是 String 主体code
user_id 是 String 用户id
user_name 是 String 用户姓名（需要对称加密再进行Base64转换）
amount 是 Integer 充值金额（分）
task_id 否 String 批次/任务id（电子卡管理后台核减批次管理，如果不传，每次核减为一个批次，且接口会返回当前批次id，后续核减如果传相同批次id，则相关核减在管理后台体现为同一批次核减。）
nonce 是 String 随机字符串（加密需使用）
associate_data 是 String 固定传 reduce（加密需使用）

# 响应说明

{
  "code": 0,
  "data": {
    "balance": 23825,
    "task_id": "1020"
  },
  "message": "成功"
}
参数名 类型 必填 描述
code int 是 0为成功，非0为失败
data.balance int 否 核减后账户余额（分）; code为0时返回
data.task_id string 否 核减批次id; code为0时返回
message string 是 接口响应说明

# 获取账户余额

# 接口说明

# 接口地址

https://open.wecard.qq.com/cgi-bin/pay/provider/recharge/balance

# 请求方法

GET

# 请求参数

access_token=OfLBovihX0ZYlKNdytgDZZhpFsygcmPK&org_code=1010343033&user_id=1762015xxxx

参数 是否必填 类型 实例 说明
access_token 是 String 应用有效凭证
org_code 是 String 主体code
user_id 是 String 用户id

# 响应说明

{
  "code": 0,
  "data": {
    "balance": 23825
  },
  "message": "成功"
}
参数名 类型 必填 描述
code int 是 0为成功，非0为失败
data.balance int 否 核减后账户余额（分）; code为0时返回
message string 是 接口响应说明

# 推送充值流水

# 接口说明

  • 建议每天0点10分启动定时任务推送昨天的充值流水，需确保凌晨1点前完成推送。
  • 数据以 billno 为唯一标识，如出现重复，以最后推送的一条为准。
  • 如数据量大，需多次调用数据推送接口分批推送。该接口限制每批最多推送100条。

# 接口地址

https://open.wecard.qq.com/cgi-bin/pay/provider/recharge/push-flows

# 请求方法

POST

# 请求参数

access_token=[鉴权token]

参数 是否必填 类型 实例 说明
access_token 是 String 应用有效凭证

# 请求body（json）

参数 是否必填 类型 示例 说明
statis_date 是 String 20220812 数据日期
flows 是 String [{"device_id":"xxx","trade_time":"2022-08-12 09:00:00"}] 流水数据。由 Flow 组成的数组，json格式，Flow 字段详情见下方说明

# 流水 Flow 说明

参数 是否必填 类型 示例 说明
billno 是 String 账单唯一标识，即充值接口里面的billno
device_id 否 String 设备ID
trade_time 是 String 2022-08-12 09:00:00 交易时间（北京时间）
user_id 是 String 学号
flow_type 否 String 类型
amount 是 Integer 100 金额（分）
status 否 String 状态

# 响应说明

{
  "code": 0,
  "data": null,
  "message": "成功"
}