H5支付接口

使用场景：手机端非微信浏览器内，或者开发者自己的app内（需要在app内调用webview组件）

请求地址（不支持浏览器直接打开）：https://open.h5zhifu.com/api/h5

调用方法：POST

请求格式：application/json

请求参数：

字段名称	字段类型	是否必填	说明
app_id	int(16)	Y	应用ID，在后台系统设置页面查看
out_trade_no	string(32)	Y	商家订单编号，即你自己系统里的订单编号，便于后续对账
description	string(32)	Y	销售商品描述
pay_type	string(32)	Y	支付类型，枚举值：alipay/wechat
amount	int(16)	Y	订单金额（注意单位为分，且为整数）
attach	string(255)	N	（选填）开发者自定义数据，在支付成功后notify回调的时候会原样返回
notify_url	string(32)	Y	支付成功后回调地址
sign	string(32)	Y	数据签名，请查看左侧签名算法

接口返回：

字段名称	字段类型	是否必填	说明
code	int(16)	Y	状态码。200：成功调用，1001：签名错误，1003：缺少参数，1004：请求值格式错误
msg	string(32)	Y	code字段所对应的详细描述信息
data	string(32)	Y	将下面的所有参数括起来
trade_no	string(32)	Y	本平台唯一订单编号，可用于查询订单状态
jump_url	string(32)	Y	前端跳转到此地址时，会唤起app支付界面
expire_time	string(32)	Y	订单过期具体时间，目前暂时指定为2小时

接口返回示例：

 {
     "code":200,
     "msg":"success",
     "data":{
          "trade_no": "201907098484845164151",
          "jump_url": "http://jump_url.com/jump_url",
          "expire_time": "2019-03-23 04:13:12",
     }
 }

注意无论用户是否付款，浏览器都会回退到原发起支付页面时，受浏览器自身限制，浏览器的setInterval计时器会自动停止，导致此时无法自动执行查单操作。但是可以监听window的pageshow，浏览器回退时会自动触发，在这里执行查单操作，示例代码如下：

window.addEventListener('pageshow', function (event) {
    var inter = setInterval(function (args) {
        if (window.queryPayStatus) {
            clearInterval(inter);
            setInterval(window.queryPayStatus,2000);
        }
     }, 1000);
});

//查询订单支付状态函数，需接入你自己系统的数据库
function queryPayStatus(){

}

常见问题解决办法：

1、出现防火墙拦截提示：请将http请求头中的user-agent设置为常见浏览器请求头，或者检查请求内容是否含有非法内容

2、是否可以不验证异步回调通知sign：不可以，因为可能会有坏人伪造异步回调通知

H5支付

H5支付接口

results matching ""

No results matching ""