充值结果通知
访问路径: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 | 系统异常 |