发起订单查询接口(可选)
订单查询接口URL:
/api/v1/charges/{tradeNo}
传参方式:Post表单
请求参数:
# | 参数名 | 含义 | 类型 | 必填 | 说明 |
---|---|---|---|---|---|
1 | tradeNo | 订单号 | string | 必填 | url路径参数。注意该字段不用参与签名 |
2 | uid | 商户uid | string | 必填 | 商户的uid。登录后台可获取 |
3 | sign | 签名参数 | string | 必填 | 参考发起付款接口 |
4 | timestamp | 系统时间戳 | string | 必填 | 当前系统时间戳(单位毫秒) |
注意:token在安全上非常重要,一定不要显示在任何网页代码、网址参数中。只可以放在服务端。计算sign时,先在服务端计算好,把计算出来的sign传出来。严禁在客户端计算sign,严禁在客户端存储token。
响应参数:
# | 参数名 | 含义 | 类型 | 说明 |
---|---|---|---|---|
1 | code | 返回码 | int(32) | 0表示接口调用正常。非0表示异常 |
2 | msg | 提示信息 | int(32) | 对应返回码code的提示信息。 |
3 | timestamp | 时间戳 | int(64) | 服务器时间戳,可用来校时。 |
4 | version | 接口版本 | string | 用途暂时保留 |
5 | data | 数据对象 | object |
请求成功时返回示例:
{ "code": 0, "msg": "调用成功。", "timestamp": "1555040027820", "version": "1.0", "data": { // 通道类型 "channelType": "alipay", // 通道名称 "channel": "alipay_hb", // 订单金额。单位:元。精确小数点后2位。例:1030.00 "money": "0.01", // 用户实际需要支付的金额。单位:元。精确小数点后2位。例:1021.16 "realMoney": "0.01", // 平台返回的订单号 "tradeNo": "323232553241366528", // 商户自己的唯一订单号 "outTradeNo": "APP323232553119731712", // 订单状态:1待支付,2支付成功,3已关闭 "status": 2, // 支付地址。商户需要展示该地址给付款用户 "payUrl": "https://www.xxxx.com/payment.html?p=DgLlHVQqblKNh242vXDGU/14wY72CQlB6Kjq7+kcTaWTrRBr/7AwjoPawz9fqO1v6yw&t=alipay", // 付款二维码图片地址。 "qrcodeUrl": "https://www.xxxx.com/upload/qrcode/d58ecb9bf1734967a7e124f6605d59cfac.jpg", // 付款二维码图片内容。 "qrcodeContent": "https://www.xxxx.com//pay/v1/go_pay?p=DgLlHVQqblKNh75643vXDGU/14wY72CQlB6Kjq7+kcTaWTrRBr/7AwjoPawz9fqO1v6yw&t=alipay", // 是否支付成功 "paySucc": true, // 是否回调成功 "notifySucc": true, // 订单有效截止时间yyyy-MM-dd HH:mm:ss,超出无法支付。默认5分钟 "validTime": "2019-04-11 23:00:46", // 订单有效截止时间戳(毫秒),超出无法支付。默认5分钟 "validTimeMills": "1554994846000" } }
请求失败时返回示例:
{ "code": 1028, "msg": "uid不存在。", "data": null, "timestamp": "1554210357457", "version": "1.0" }