状态查询
访问路径: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 | 系统异常 |