余额查询

访问路径：api/1/wx/recharge/balance

接口说明：一卡通系统提供一卡通账户余额查询接口，三方支付平台通过该接口为用户提供一卡通账户余额查询。

URL结构

https://api.17wanxiao.com/api/1/wx/recharge/balance

接口协议：HTTPS

HTTP请求方式：POST

请求参数

参数	必选	类型	说明
access_token	true	string	访问令牌，请妥善保管，泄漏会导致用户信息泄漏
app_id	true	int	接入应用编号；固定值,接入时会分配
pay_code	true	string(16)	支付方式编码；固定值,接入时会分配，可参考：支付方式编码表
norce_str	true	string(32)	随机数，最大32位，保证签名不可预测,建议：时间戳+16位随机数

请求示例

请求示例不包含支付签名步骤，只展示请求报文; 使用curl进行展示:

curl -d "app_id=143&pay_code=118208&norce_str=41912320160825101056123" "https://api.17wanxiao.com/api/1/wx/recharge/balance?access_token=ACCESS_TOKEN"

返回参数

参数	必选	类型	说明
card_balance	true	numeric(0,16)	卡余额，单位为元。可含小数。
unsettle_amount	true	numeric(0,16)	未结算余额，单位为元。可含小数。
db_balance	true	numeric(0,16)	库余额，单位为元。可含小数。
balance_time	true	string(32)	余额对应时间，格式：yyyyMMdd
return_code	true	string	操作结果：SUCCESS为修改成功，其他则为失败
return_message	true	string	操作结果描述信息
norce_str	true	string(32)	随机数，保证签名不可预测

返回示例

（只展示返回报文,签名验证没有展示，注意做签名！）

                    
                    {
                      "card_balance": 100,
                      "unsettle_amount": 100,
                      "db_balance": 100,
                      "balance_time": "20160606",
                      "return_code": "SUCCESS",
                      "return_message": "操作成功",
                      "norce_str": "14708823639833029485671238"
                    }

返回错误码

返回错误码（return_code）	错误说明
ILLEGAL_SCHOOL	学校编码不合法
ILLEGAL_CARD_NAME	卡号姓名不匹配
ILLEGAL_CARD	无效的卡号
ILLEGAL_STUDENT_NO	无效的学号
ILLEGAL_TEMP_CARD	临时卡，不能查询
ILLEGAL_STATUS_CARD	该卡可能已被注销，冻结或者挂失

开发者文档