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:不可以,因为可能会有坏人伪造异步回调通知

results matching ""

    No results matching ""