开发者文档

充值结果通知

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

接口说明:三方支付平台代扣完成后,向一卡通系统发起支付(充值)结果通知。

URL结构

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

接口协议:HTTPS

HTTP请求方式:POST

请求参数

参数 必选 类型 说明
access_token true string 访问令牌,请妥善保管,泄漏会导致用户信息泄漏
app_id true int 接入应用编号;固定值,接入时会分配
pay_code true string(16) 支付方式编码;固定值,接入时会分配,可参考: 支付方式编码表
recharge_order_no true string(32) 三方支付平台的每一个一卡通充值请求对应一个唯一的单据号。
三方支付平台如果有则传, 如果没有则传申请充值流水号(apply_id字段, 和api/1/pay/apply中的此字段名称和值相同)
apply_id true string(24) 申请充值流水号,,和api/1/pay/apply中的此字段名称和值相同
out_id true string(24) api/1/pay/apply请求返回的此字段相同
recharge_amount true int (0,16) 充值金额,为正整数,单位:元
pay_time true string(32) 格式为:yyyyMMddhhmmss 样例: 20130318102012
norce_str true string(32) 随机数,最大32位,保证签名不可预测,建议:时间戳+16位随机数

请求示例

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

curl -d "app_id=143&pay_code=118208&apply_id=201608251010561234&recharge_amount=1&recharge_order_no=20160825101420567890&out_id=123&pay_time=20160825101539&norce_str=41912320160825101056123" "https://api.17wanxiao.com/api/1/wx/recharge/submit?access_token=ACCESS_TOKEN"

返回参数

参数 必选 类型 说明
recharge_order_no true string 一卡通充值单据号
out_id true int 学校编号
recharge_amount true string 充值金额
return_code true string 操作结果:SUCCESS为修改成功,其他则为失败
return_message true string 操作结果描述信息
norce_str true string(32) 随机数,保证签名不可预测

返回示例

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

                    
                    {
                      "recharge_order_no": "1462763798794",
                      "out_id": "20160606081818123456",
                      "recharge_amount": 100,
                      "return_code": "SUCCESS",
                      "return_message": "操作成功",
                      "norce_str": "14708823639833029485671238"
                    }

                    
                    

返回错误码

返回错误码 (return_code) 错误说明
ILLEGAL_RECHARGE_AMOUNT 充值金额不合法
ILLEGAL_OUT_ID 无效的代扣请求流水号
ILLEGAL_STUDENT_NO 无效的学号
SYSTEM_ERROR 系统异常