微信H5支付
1. 简介
1.1 应用场景
商户已有H5商城网站，用户通过消息或扫描二维码在微信内打开网页时，可以调用微信支付完成下单购买的流程。
1.2 操作步骤
步骤二：业务平台选购后，调用国通支付接口发起支付，国通调用微信官方JSAPI下单接口，获取预支付订单ID返回业务平台。
步骤三：业务平台获取预支付订单ID后，调用微信官方支付控件，拉起密码支付框，用户输入密码完成支付。
步骤四：密码验证通过，支付成功。商户后台得到支付成功的通知。
步骤五：进入支付完成页，该页面可展示商户小票及微信官方点金广告等。
步骤六：微信支付公众号下发支付凭证通知。
可以通过国通演示二维码体验了解在H5网页中支付演示效果，演示程序自动识别当前的环境是微信、支付宝、银联云闪付，程序会自动根据环境展示适用的支付方式；下图是演示H5页面的二维码（已跳过商品选购业务环节）。
2.对接准备
【微信参数】指合作方在微信官方公众号平台申请公众号、配置交易授权地址等。
①已在微信官方注册公众号，建议使用企业主体信息注册，获取APPID及生成秘钥用于获取消费者OPENID使用。
②商户已有公众号商城网站或服务，并且已经过ICP备案，并在微信官方公众号平台内完成配置。
③微信公众号后台配置授权域名，将微信校验文件放到服务器根目录下。
④提供商户或服务商主体的公众号，并在国通开通微信支付业务并配置公众号appid、交易授权地址等。
【机构开立】合作方提供企业相关信息，由国通产品运营人员申请开立后提供，用于传参使用。
【公钥获取】在进行联调之前，您需要获取公钥用于加密和签名等安全处理操作。这些公钥通常由国通产品运营通过邮件方式下发给合作方，在获取公私钥之后，请注意以下几点：
①区分测试环境和生产环境：确保您从国通产品运营那里获取到的公私钥是适用于相应环境（测试或生产）的。测试环境用于开发、调试和测试过程，而生产环境则是实际交易的环境。
②保证安全性：公私钥是非常重要的安全资料，请妥善保存，避免泄漏给未授权的人员或第三方。建议将其存储在安全的位置，并定期更换密钥以增强系统的安 全性。
③配置正确：在进行联调时，请确保将相应的公私钥配置到您的系统中，并在请求和响应中使用正确的密钥进行加密和解密、签名和验签等操作。
如果您尚未收到公私钥或有任何疑问，请及时与国通产品运营联系，确保正确获得所需的安全资料，以便顺利进行联调和交易对接。
【商户入网】提供商户入网申请相关资料。这些资料可能包括商户基本信息、营业执照、身份证信息、银行账户等，提交审核通过后将生成国通600商户号，用于传参使用。
①国通APP入网/代理平台入网：测试环境由合作方提供信息，国通产品运营人员申请入驻，生产环境由合作方使用国通APP或国通机构平台入驻（国通APP使用方式及机构账号可联系市场对接人员获取）。
②接口API入网：合作方通过国通入网接口完成商户入网，企业商户调用安心签企业用户开户及普通商户申请入驻 、小微商户调用安心签个人用户开户及小微商户申请入驻， 完成开户、绑卡、结算费率配置。
【商户认证】调用交易接口前，商户除完成入网审核，还需进行商户与微信APPID&交易授权地址关联及渠道认证。调用接口流程如下：
①微信APPID&交易授权地址关联，该点根据项目情况不同，处理方案不同，若项目仅使用一套公众号参数，并且独立开立机构，则由产品运营协助配置；若项目使用多套则需要合作方调用接口“商户服务化配置信息配置”进行配置。
②商户渠道认证，该点根据项目情况不同，处理方案不同，若项目使用国通渠道码则由产品运营提供认证码，若项目独立申请，则申请后向商户提供认证码完成认证。未完成认证前调用交易则报“FMZ商户需完成微信认证 (补齐材料)，请联系商家”
认证渠道样式如图：
③商户认证情况可前往微信服务商平台，通过微信子商户号查询（微信支付-中国领先的第三方支付平台｜微信支付提供安全快捷的支付方式(qq.com)）
④认证使用的微信子商户号，可调用接口“查询报备信息”查询或登录国通商户APP-商户管理页面/国通机构平台查看。
3.接口调用
3.1业务流程图
3.2交易处理流程
1、获取微信openid，参考微信官方文档：微信网页授权；
2、调用星驿付JSAPI支付接口，传入微信相关参数，获取微信支付信息；
3、下单成功后根据返回的微信支付信息，由商户的服务端传给前端并调用微信JSAPI调起支付；
4、调用订单查询接口，主动查询支付订单的交易结果，或者通过交易通知获取支付订单的交易结果；
5、服务商/商户，如果发现某个支付订单迟迟没有获取到支付结果，则可调用关闭订单接口，关闭某笔支付订单，关闭后该笔支付订单将不会继续支付。
3.3退款处理流程
【发起退款请求】商户通过支付系统的接口发起退款请求，提供相关的订单信息和退款金额。
【接受退款请求】支付系统接收到退款请求后，会验证退款信息和可用余额是否足够，然后进行退款处理。
【处理退款】支付系统将退款请求发送给支付机构，并等待支付机构的确认和处理。
【支付机构处理】支付机构接收到退款请求后，会对退款进行审核，并根据相关规定处理退款。如果退款请求符合 条件，支付机构会将退款金额从商户的账户中扣除，并将资金退还给消费者。
【退款结果通知】支付机构将退款结果通知商户，商户可以根据通知结果更新订单状态或者向消费者进行相应的通知。
【资金返还】退款成功后，资金将按照原来的支付方式返回给消费者。如果是信用卡支付，则会将退款金额返还到消费者的信用卡账户；如果是支付宝、微信等第三方支付，资金会返回到消费者的支付账户中。
需要注意的是，退款的具体流程可能因支付系统和支付机构的不同而有所差异。商户和消费者在进行退款操作时，应根据具体的支付平台和相关规定来进行操作。
①银联微信、银联支付宝、银联小微通道交易支持90天内交易退款，ATQ通道支持30天内交易退款并且需同通道存在余额；
②同一笔订单多次退款的请求需相隔1分钟
③同一商户每秒最大退款频率为10次
④申请退款接口的返回仅代表业务的受理情况，具体退款是否成功，需要通过退款查询接口获取结果
⑤支付宝通道每日23点54分至零点不支持退款
⑥错误或无效请求频率限制: 6qps，即每秒钟异常或错误的退款申请请求不超过6次
⑦部分退款时，手续费计算不四舍五入进1，当交易全额退款时全部手续费退回
退款存在部分退款和全额退款（1）全额退款手续费取原手续费（2）部分退款手续费 算法如下：
a.先算出退 款金额比率=退款金额/原交易金额（四舍五入保留小数点后10位）
b.退款手续费=原订单手续费退款金额比率（单位精确分小数后不保留）
c.如退款金额为最后一笔对应退款取剩余退款手续费
案例：
原交易金额：10000；退款金额：5414.14；退款比率：0.5414140000；原手续费：0.99
退款手续费：0.990.5414140000=0.53599986
小数点保留到分最终结果：0.53
如果第二笔订单退款金额4585.86
此时剩余退款金额为4585.86与退款金额一致：
相当于把剩下交易金额全部退掉
退款手续费算法为：原退款手续费-已退款手续费即：0.99-0.53=0.46
3.4对账流程
【下载对账单】商户可以通过国通提供的接口（SFTP文件，需要添加IP白名单）或机构后台管理系统下载对账单。对账单包含了一段时间内的交易记录和相关的交易信息。
【对账处理】商户将对账单与自己的财务系统进行对比，核对每笔交易的金额、订单号、手续费等信息是否一致。如果发现异常或不一致的交易，商户需要进行调查和处理。
【异常处理】如果商户发现对账中存在异常的交易，如金额错误 、重复交易、未完成的退款等，商户需要及时联系国通的技术支持团队或支付机构进行进一步调查和解决问题。
【对账结果确认】商户在核对完所有交易后，应确认对账结果。如果对账无误，商户可以认定交易数据准确无误；如果发现异常，商户需要协调解决问题并与国通或支付机构进行沟通。
4.常见问题
问题原因：此错误一般是商户还没有完成微信实名认证。
解决方案：完成微信实名认证，扫拓展码进行实名验证（可联系国通人员指导）
问题原因：网页授权页面未正确配置。
解决方案一：登录服务商微信后台配置下网页授权域名，微信后台在设置与开发→公众号设置→功能设置中找到网页授权域名
解决方案二：调用接口为商户配置正确的授权地址，配置微信支付目录（/yyfsevr/addCust/wxPayConfig）
解决方案三：前往微信服务商平台手动配置【微信支付合作伙伴平台｜平台开放更多能力，与合作伙伴一起成长 (qq.com)】
③微信支付时，接口报错：“sub_mch_id与sub_appid不匹配”
问题原因：微信公众号/小程序支付时报此错误，一般是商户未正确配置交易所使用的微信公众号/小程序appid到微信侧。
解决方案一：调用接口为商户配置正确的APPID，微信APPID配置（/yyfsevr/addCust/appidConfig）。
解决方案二：联系国通人员在国通平台配置。
解决方案三：前往微信服务商平台手动配置【微信支付合作伙伴平台｜平台开放更多能力，与合作伙伴一起成长 (qq.com)】
修改于 2026-03-16 03:13:22