开发者文档

充值付款申请

访问路径:api/1/wx/recharge/apply

接口说明:该接口主要是由三方支付平台发起的充值。一卡通系统提供付款申请接口,三方支付平台通过该接口发起付款申请,一卡通系统收到付款申请后,需要校验请求信息是否合法,并发起一笔支付申请,返回信息中包含一卡通支付申请的流水号

URL结构

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

接口协议:HTTPS

HTTP请求方式:POST

请求参数

参数 必选 类型 说明
access_token true string 访问令牌,请妥善保管,泄漏会导致用户信息泄漏
app_id true int 接入应用编号;固定值,接入时会分配
pay_code true string(16) 支付方式编码;固定值,接入时会分配,可参考: 支付方式编码表
apply_id true string(24) 申请充值流水号(第三方定义)
apply_amount true numeric(0,16) 申请充值金额,为正整数,单位:元
type true string(16) 可能的支付充值类型:
10:自动充值
20:多媒体充值
30: PC 充值
40:手机客户端充值
50:短信充值
norce_str true string(32) 随机数,最大32位,保证签名不可预测,建议:时间戳+16位随机数

请求示例

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

curl -d "app_id=143&pay_code=118208&apply_id=201608251010561234&apply_amount=1&type=10&norce_str=4191232016082510105611" "https://api.17wanxiao.com/api/1/wx/recharge/apply?access_token=ACCESS_TOKEN"

返回参数

参数 必选 类型 说明
return_code true string 操作结果:SUCCESS为修改成功,其他则为失败
return_message true string 操作结果描述信息
out_id true string(24) 一卡通业务流水号
apply_id true string(32) 充值申请流水号
card_balance true numeric(0,16) 卡余额,正整数,单位:元
unsettle_amount true numeric(0,16) 未结算余额,单位为元。不含小数
db_balance true numeric(0,16) 库余额,单位为元。不含小数
norce_str true string(32) 随机数,保证签名不可预测

返回示例

(只展示返回报文,签名验证没有展示,注意做签名!)

                    
                    {
                      "return_code": "SUCCESS",
                      "return_message": "成功",
                      "out_id": "1234567890",
                      "apply_id": "2016060608161600000",
                      "card_balance": 100,
                      "unsettle_amount": 100,
                      "db_balance": 100,
                      "norce_str": "14708823639833029485671238"
                    }

                    
                    

返回错误码

返回错误码 (return_code) 错误说明
ILLEGAL_SCHOOL 学校编码不合法
ILLEGAL_CARD_NAME 卡号姓名不匹配
ILLEGAL_CARD 无效的卡号,卡号不正确
ILLEGAL_STUDENT_NO 无效的学号
ILLEGAL_TEMP_CARD 临时卡,不能充值
ILLEGAL_STATUS_CARD 该卡可能已被注销,冻结或者挂失