微信支付
1. 简介
1.1 应用场景
1.2 操作步骤
2.对接准备
【微信参数】指合作方在微信公众平台有账号而且有小程序，开发阶段可以使用体验版本进行测试，需要将小程序先上线，小程序上线需通过微信审核。
【机构开立】合作方提供企业相关信息，由国通产品运营人员申请开立后提供，用于传参使用。
【公钥获取】在进行联调之前，您需要获取公钥用于加密和签名等安全处理操作。这些公钥通常由国通产品运营通过邮件方式下发给合作方，在获取公私钥之后，请注意以下几点：
①区分测试环境和生产环境：确保您从国通产品运营那里获取到的公私钥是适用于相应环境（测试或生产）的。测试环境用于开发、调试和测试过程，而生产环境则是实际交易的环境。
②保证安全性：公私钥是非常重要的安全资料，请妥善保存，避免泄漏给未授权的人员或第三方。建议将其存储在安全的位置，并定期更换密钥以增强系统的安全性。
③配置正确：在进行联调时，请确保将相应的公私钥配 置到您的系统中，并在请求和响应中使用正确的密钥进行加密和解密、签名和验签等操作。
如果您尚未收到公私钥或有任何疑问，请及时与国通产品运营联系，确保正确获得所需的安全资料，以便顺利进行联调和交易对接。
【商户入网】提供商户入网申请相关资料。这些资料可能包括商户基本信息、营业执照、身份证信息、银行账户等，提交审核通过后将生成国通600商户号，用于传参使用。
①国通APP入网/代理平台入网：测试环境由合作方提供信息，国通产品运营人员申请入驻，生产环境由合作方使用国通APP或国通机构平台入驻（国通APP使用方式及机构账号可联系市场对接人员获取）。
②接口API入网：合作方通过国通入网接口完成商户入网，企业商户调用安心签企业用户开户及普通商户申请入驻 、小微商户调用安心签个人用户开户及小微商户申请入驻， 完成开户、绑卡、结算费率配置。
【商户认证】调用交易接口前，商户除完成入网审核，还需进行商户与微信APPID&交易授权地址关联及渠道认证。调用接口流程如下：
①微信APPID&交易授权地址关联，该点根据项目情况不同，处理方案不同，若项目仅使用一套公众号参数，并且独立开立机构，则由产品运营协助配置；若项目使用多套则需要合作方调用接口“商户服务化配置信息配置”进行配置。
②商户渠道 认证，该点根据项目情况不同，处理方案不同，若项目使用国通渠道码则由产品运营提供认证码，若项目独立申请，则申请后向商户提供认证码完成认证。未完成认证前调用交易则报“FMZ商户需完成微信认证 (补齐材料)，请联系商家”
认证渠道样式如图：
③商户认证情况可前往微信服务商平台，通过微信子商户号查询（微信支付-中国领先的第三方支付平台｜微信支付提供安全快捷的支付方式(qq.com)）
④认证使用的微信子商户号，可调用接口“查询报备信息”查询或登录国通商户APP-商户管理页面/国通机构平台查看。
3.接口调用
3.1交易处理流程
1、消费者在商户的APP中选购商品，消费者确定后支付；
2、APP生成商户的订单后，通过微信的SDK，调用WXLaunchMiniProgram接口来实现APP跳转微信小程序，可参考微信APP拉起小程序功能；
3、微信小程序获取用户openid，可参考微信小程序获取openid；
4、使用获取到的openid调用星驿付的JSAPI支付接口，获取支付信息；
5、小程序使用下单返回的支付信息调起支付密码框完成支付；可参考微信小程序调起支付
6、支付完成后小程序跳回商户APP，商户APP展示支付结果。参考微信小程序跳回APP。
3.2退款处理流程
【发起退款请求】商户通过支付系统的接口发起退款请求，提供相关的订单信息和退款金额。
【接受退款请求】支付系统接收到退款请求后，会验证退款信息和可用余额是否足够，然后进行退款处理。
【处理退款】支付系统将退款请求发送给支付机构，并等待支付机构的确认和处理。
【支付机构处理】支付机构接收到退款请求后，会对退款进行审核，并根据相关规定处理退款。如果退款请求符合条件，支付机构会将退款金额从商户的账户中扣除，并将资金退还给消费者。
【退款结果通知】支付机构将退款结果通知商户，商户可以根据通知结果更新订单状态或者向消费者进行相应的通知。
【资金返还】退款成功后，资金将按照原来的支付方式返回给消费者。如果是信用卡支付，则会将退款金额返还到消费者的信用卡账户；如果是支付宝、微信等第三方支付，资金会返回到消费者的支付账户中。
需要注意的是，退款的具体流程可能因支付系统和支付机构的不同而有所差异。商户和消费者在进行退款操作时，应根据具体的支付平台和相关规定来进行操作。
①银联微信、银联支付宝、银联小微通道交易支持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.3对账流程
【下载对账单】商户可以通过国通提供的接口（SFTP文件，需要添加IP白名单）或机构后台管理系统下载对账单。对账单包含了一段时间内的交易记录和相关的交易信息。
【对账处理】商户将对账单与自己的财务系统进行对比，核对每笔交易的金额、订单号、手续费等信息是否一致。如果发现异常或不一致的交易，商户需要进行调查和处理。
【异常处理】如果商户发现 对账中存在异常的交易，如金额错误、重复交易、未完成的退款等，商户需要及时联系国通的技术支持团队或支付机构进行进一步调查和解决问题。
【对账结果确认】商户在核对完所有交易后，应确认对账结果。如果对账无误，商户可以认定交易数据准确无误；如果发现异常，商户需要协调解决问题并与国通或支付机构进行沟通。
4.常见问题
问题原因：此错误一般是商户还没有完成微信实名认证。
解决方案：完成微信实名认证，扫拓展码进行实名验证（可联系国通人员指导）
问题原因：微信公众号/小程序支付时报此错误，一般是商户未正确配置交易所使用的微信公众号/小程序appid到微信侧。
解决方案一：调用接口为商户配置正确的APPID，微信APPID配置（/yyfsevr/addCust/appidConfig）。
解决方案二：联系国通人员在国通平台配置。
解决方案三：前往微信服务商平台手动配置【微信支付合作伙伴平台｜平台开放更多能力，与合作伙伴一起成长 (qq.com)】
修改于 2026-03-30 08:51:36