H5微信唤醒支付怎么对接:浏览器跳转、支付查单与余额回调

H5微信唤醒支付,是用户在手机浏览器的网站页面发起付款,再跳转微信收银台完成支付。接入时要把网页跳转、服务端确认付款和网站增加余额连成闭环。本文依据微信支付官方资料解释流程;通过稳付pay接入时,具体H5能力、商户权限和接口参数须由技术人员确认。

按主题继续阅读

一、分清H5、微信内网页和APP支付

微信官方H5支付面向微信客户端以外的手机浏览器网页。微信内打开的网页通常对应JSAPI支付,原生APP则使用APP支付;不能因为APP内嵌了网页,就直接把它当作官方H5使用场景。本文参考的第二份官方链接是APP开发指引,其中的OpenSDK、sendReq和onResp属于另一套流程。

普通商户直接接入官方H5前,需要具备相应商户资质、H5产品权限、商户号与APPID绑定关系,并配置H5支付域名。申请要求以官方当前说明为准。网站走稳付pay聚合通道时,应先告知技术人员域名、业务内容和打开方式,确认分配通道是否支持H5;本文上线不代表为所有商户开通了该能力。

不要按浏览器名称猜接口,也不要把所有“微信原生通道”都理解成同一种H5能力。先确认实际场景、权限和通道,再确定前端跳转方式与后端协议。

二、稳付pay接入教程:从申请通道到测试上线

第1步,联系稳付pay的@tonyyyds,说明网站域名、业务类型、手机浏览器或APP等使用场景、充值或订阅流程、预计订单量,以及USDT结算需求。技术人员会确认H5能力、可用通道、费率、结算口径和联调安排;不能只看到通道名称就默认已经开通。

第2步,取得实际网关、商户号mchId、已授权wayCode和服务端密钥,准备公网notifyUrl及本地订单表。密钥只放后端。微信聚合编码示例是90001,支付宝聚合编码示例是80001,只有商户已获授权时才可使用,也可能分配真实通道编码。

第3步,后端保存唯一outTradeNo和可信金额,再按下单文档向POST /api/pay/collect/create发送JSON。amount以整数分提交,1000表示10元;reqTime使用当前毫秒整数,sign由后端按实际MD5规则生成。下面仅展示本篇支付方式的字段,占位值必须替换并重新签名。

稳付pay代收字段示意:替换占位值,将reqTime改为当前毫秒整数,并在后端生成签名;不要原样提交。
{
  "mchId": "YOUR_MERCHANT_ID",
  "wayCode": "90001",
  "outTradeNo": "YOUR_UNIQUE_ORDER_NO",
  "amount": 1000,
  "currencyCode": "CNY",
  "notifyUrl": "https://merchant.example.com/pay/notify",
  "subject": "WENFUPAY_H5_DEMO",
  "reqTime": "CURRENT_UNIX_MILLISECONDS",
  "sign": "GENERATE_MD5_ON_SERVER"
}

第4步,保存返回的平台订单号,取得有效payUrl后按技术方案展示或跳转,不自行拼接微信或支付宝收银台链接。code=0仅代表请求业务受理成功,不能直接增加余额。H5跳转能否直接唤起客户端,以实际通道和浏览器联调结果为准。

第5步,接收稳付pay统一JSON通知,先验签再核对商户、订单、金额和币种,成功后仅记账一次;可靠保存后返回HTTP 200与纯文本OK。未收到通知或下单结果未知时,由后端用原订单调用GET /api/pay/collect/query补核,查询金额单位按开通说明确认。

第6步,在技术人员安排的测试环境验证支付、取消、超时、重复回调及余额更新,核对首批正式订单后逐步放量。下面提供接入咨询和完整文档入口。

三、为什么用稳付pay:通道与服务优势

多种收款选择:目前提供微信个码代收、微信原生代收、支付宝原生代收,并支持聚合接入。商户按实际业务配置支付方式,可减少逐个对接不同渠道的工作;具体H5能力仍取决于已开通通道。现有通道成功率表现稳定,实际结果受订单、用户环境和通道状态影响,不承诺固定百分比。

统一订单与回调:前端使用返回的支付入口,后端按统一下单、查询与JSON回调流程处理,便于把网站充值、会员订阅、发卡或TG机器人订单接到自己的业务系统。平台负责支付状态通知,用户余额和权益由商户按可信结果更新,不能把回调成功等同于所有业务都自动完成。

T0实时USDT结算:用户付款确认后,可按双方约定向商户实时结算USDT,方便有该结算需求的网站安排资金。开通时确认可结算金额、服务费、换算口径、结算网络和地址;实际处理及链上到账仍有条件与确认过程,不等于零费用、零确认或所有订单无条件秒到。

技术人员协助联调:从商户参数、通道选择、签名、查单到回调异常可联系团队确认。微信、支付宝代收后以USDT结算,与USDT链上自有地址监控是两种资金路径;后者是客户直接转到商户钱包,由稳付pay监控确认并回调,不能混写成同一服务。

四、官方H5与稳付pay支付链接如何区分

先由网站后端创建本地订单,绑定登录用户、商品或充值档位、金额与币种。金额从服务端价目表读取,不能信任前端自行提交的价格。直接接官方API v3时,后端请求POST /v3/pay/transactions/h5,使用唯一out_trade_no,提交notify_url、amount及scene_info等要求字段;amount.total是人民币分,例如10元填写1000。签名与私钥留在服务端。稳付pay通道应使用实际文档的字段、单位和签名规则,不能直接套用官方参数。

取得h5_url后,由已配置H5支付域名的页面跳转该地址。指定返回页面时,将redirect_url作为查询参数追加到原支付链接,完整保留原有参数,并对返回地址正确编码一次;返回域名也必须是已配置的H5支付域名。使用URL构造工具时避免重复编码。redirect_url是浏览器返回地址,notify_url是服务端付款通知地址,不能互相代替。

官方H5开发指引给出的h5_url有效期是5分钟,不等于订单整体支付期限。链接过期后先核对订单状态;仍可付款时,按官方规则用原下单参数获取新链接。业务订单超过支付期限时,先查单再按接口规则关单或重建,不能仅凭页面倒计时认定付款失败。

五、返回后查单,确认成功再回调和增加余额

支付完成与中途取消都可能返回商户页面。因此,回到redirect_url、前端显示成功或者用户上传付款截图,都不能单独作为增加余额的依据。返回页可提供“我已支付,查询结果”按钮,由网站后端按该用户有权查看的订单查单,展示已付款、待确认等真实状态。不要根据返回地址中的金额或success参数直接入账。

直接接官方API的系统按API v3规范验证通知、解密资源并核对订单;稳付pay商户按实际回调文档验签。两者都要核对收款身份、商户订单号、交易号、预期金额与币种。查单和回调进入同一套状态处理逻辑,不能把晚到的未支付结果覆盖已经确认的成功结果。

以网站充值为例,为业务订单建立唯一入账记录,在同一数据库事务内更新订单与余额流水。回调重试、多次查单或页面刷新不能再加一次钱。会员或商品交付也要防重;付款已确认但权益处理失败时保留可重试任务,不要求用户重新付款。通知已可靠落库后,按所用接口约定应答。

六、唤不起微信、返回空白和到账延迟怎么验收

唤不起时记录订单号、发生时间、系统与浏览器、实际打开场景、错误提示及脱敏请求标识。依次检查H5权限与域名、链接是否过期、跳转链是否保留必要信息、客户端是否允许打开微信。不要通过伪造来源或绕过域名检查解决问题,也不要承诺所有浏览器都能自动唤醒。

返回空白时检查redirect_url编码、返回域名、页面路由及登录态恢复。付款已确认但余额未变时,沿交易记录、回调验签、订单状态、入账流水定位;未收到回调可查单补核,不能盲目重建已付款订单。日志要脱敏,支付链接和密钥不应进入公开工单或网页。

验收至少覆盖正常支付、取消返回、链接过期、关闭页面、回调晚到或重复、查单与回调并发、余额写入失败后恢复。确认同一订单仅入账一次,订单号贯穿支付、通知和余额流水。稳付pay可协助确认接入与回调方案;费率、通道范围及USDT结算条件另行约定,唤起收银台不代表付款或商户结算已经完成。

常见问题

H5唤醒支付不需要商户资质,也不用配置域名吗?

不是。直接接微信官方H5需要满足其商户与产品权限要求,并配置H5支付域名。通过稳付pay接入时,可用场景、业务审核、域名及参数由技术人员核实,不能理解为免审核或绕过微信规则。

用户点了完成,却没有收到回调,可以直接给余额吗?

不能仅凭前端动作增加余额。网站后端先查证付款结果,核对商户、金额与币种,再通过统一防重入账流程处理。仍无法确认时显示待核实并提供订单号排查,避免用户重复支付。

参考资料