开发者文档

状态查询

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

接口说明:一卡通系统提供交易查询接口,三方支付平台通过外部交易流水号,查询一卡通系统中该交易处理情况;通过该接口为客服人员提供方便、准确的信息。

URL结构

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

接口协议:HTTPS

HTTP请求方式:POST

请求参数

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

请求示例

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

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

返回参数

参数 必选 类型 说明
return_code true string 操作结果:SUCCESS为修改成功,其他则为失败
return_message true string 操作结果描述信息
out_id true string 一卡通业务流水号
order_status true int 一卡通充值交易状态; 状态码说明: 10 一卡通交易申请已生成 20 该状态针对一卡通主动发起的代扣,表示三方支付平台已受理一卡通的代扣请求 30 该状态针对一卡通主动发起的代扣,表示三方支付平台交易处理成功 40 已应答三方支付平台交易处理结果 50 该状态针对一卡通主动发起的代扣,表示一卡通充值成功之后,已通知三方支付平台充值结果 60 该状态针对一卡通主动发起的代扣,表示三方支付平台已应答充值结果
desc false string(100) 订单交易描述
norce_str true string(32) 随机数,保证签名不可预测

返回示例

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

                    
                    {
                      "out_id": "1234567890",
                      "order_status": 10,
                      "desc": "",
                      "return_code": "SUCCESS",
                      "return_message": "操作成功",
                      "norce_str": "14708823639833029485671238"
                    }


                    
                    

返回错误码

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