一、微信支付接入指南

1.1 微信支付的前提条件

微信支付接入需要已经完成微信认证的服务号。如果是小程序的话，也需要完成微信认证。
Test

1.2 微信商户平台

商户分为普通商户和服务商商户，千万不要申请错了。
普通商户是可以进行交易，但是不能拓展商户。
服务商可以拓展商户，但是不能交易。
服务商就是提供统一的支付入口，它需要绑定具体的普通商户，微信支付时会在支付接口中携带普通商户参数，支付成功后金额会直接到具体的普通商户账户上。
申请时直接申请普通商户就可以了。

1.3 绑定商户

如果商户和需要绑定的AppID是同一主体，只需要以下步骤即可完成绑定。

在商户平台-产品中心-AppID账户管理中关联AppID，输入AppId申请绑定

如果商户和需要绑定的AppID是不同主体，步骤和上述一样，除了输入AppId之外，还需要填入AppId的认证信息。

1.3 二、微信支付相关配置

2.1 支付产品类型
  1. 付款码支付
  2. JSAPI支付
  3. APP支付
    商户APP中集成微信SDK，用户点击后跳转到微信内完成支付。
  4. H5支付
    用户在微信以外的手机浏览器请求微信支付的场景唤起微信支付。
  5. 小程序支付
    用户在微信小程序中使用微信支付的场景。
  6. 刷脸支付
    无需掏出手机，刷脸完成支付，适合线下各种场景。
    在商户平台-产品中心-我的产品中申请开通支付产品。
2.2 支付授权目录配置

在商户平台-产品中心-开发配置中进行支付授权目录的配置（即你开发的下单接口地址），需要注意的是授权目录最多可以配置五个，在开发过程中请合理定义支付接口。

2.3 配置商户密钥

在商户平台-账户中心-API安全中设置API密钥。
第一次设置时，需要安装操作证书，傻瓜式安装，按照提示一步一步操作就可以。
API密钥需要是一个32位的随机字符串，记得不要随意更改API密钥。
在微信API v3版本中，除了要配置API密钥外，还需要配置APIv3密钥和申请CA颁发的API证书。

API v3密钥主要用于平台证书解密、回调信息解密。
API证书用于调用更高级别的API接口，包含退款、红包等接口。

如果使用开源的微信开发包，请了解是否支持v3版本。

2.4 配置服务器
2.5 白名单配置
2.6 JS接口安全域名

JSAPI
小程序

支付协议
HTTP/HTTPS

HTTPS

支付目录
有
无

授权域名
有
无

1.4 三、微信支付流程

由于微信升级了API接口，在API v3接口中，需要：

Test
上面的这张图片来自微信开发文档，我们详细分析一下支付流程。

3.1 微信下单接口

用户通过微信客户端发起支付，在商戶后台生成订单，然后调用微信下单接口，生成预支付订单，返回订单号！
下单接口涉及到的主要参数，只列举重要的几个参数：

请求参数
是否必传
类型
描述

appid
是
String

mch_id
是
商户号

nonce_str
是
随机字符串，32位以内

sign
是
签名，默认使用MD5进行加密

out_trade_no
是
系统内部订单号

total_fee
是
Int
订单总金额，单位是分

notify_url
是
支付结果通知接口

sign 的签名也比较通用，涉及了一个保证签名不可预测的 nonce_str：

  1. 将所有发送的非空参数使用字典排序生成键值对（key1=value1&key2=value2）
  2. 将商户平台密钥拼接在上述字符串的最后（”String”+&key=密钥）
  3. 将上述字符串采用MD5加密
3.2 支付

拉起微信支付，输入密码，完成支付。这一步需要在H5网页中执行JS调起支付。
需要以下参数，因此在预付订单返回和，需要将下列参数封装后响应给页面，由页面完成支付。

参数名
是否必传
类型
描述

appId
是

timeStamp
是
当前时间戳

nonceStr
是
随机字符串

package
是
预支付订单，格式为prepay_id=***

signType
是
签名类型，默认MD5

paySign
是
签名

签名和下单接口的签名方式一样。
JS伪代码如下：

 function onBridgeReady(){
   WeixinJSBridge.invoke(
       'getBrandWCPayRequest', {
           "appId":"wx2421b1c4370ec43b",
           // 时间戳，自1970年以来的秒数
           "timeStamp":"1395712654",  
           // 随机串
           "nonceStr":"e61463f8efa94090b1f366cccfbbb444",
           "package":"prepay_id=u802345jgfjsdfgsdg888", 
           // 微信签名方式
           "signType":"MD5",
           // 微信签名
           "paySign":"70EA570631E4BB79628FBCA90534C63FF7FADD89"
       },
       function(res){
           if(res.err_msg == "get_brand_wcpay_request:ok" ){
               // 使用以上方式判断前端返回,微信箱：
               // res.err_msg将在用户支付成功后返回ok，但并不保证它绝对可靠。
           } 
       }); 
if (typeof WeixinJSBridge == "undefined"){
   if( document.addEventListener ){
       document.addEventListener('WeixinJSBridgeReady', onBridgeReady, false);
   }else if (document.attachEvent){
       document.attachEvent('WeixinJSBridgeReady', onBridgeReady); 
       document.attachEvent('onWeixinJSBridgeReady', onBridgeReady);
   }
}else{
   onBridgeReady();
}

注意伪代码中的这句话： 
为什么这么说呢，我举个例子应该就明白了。假如你去超市买东西，是不是你说支付成功了你就可以把东西带走呢？肯定不是，是当商家收到钱后才算你支付成功，你才可以把东西带走。也就是说，这里提示的成功并不能说一定支付成功了，具体是否成功，微信平台会以异步的方式给你进行通知。 
##### 3.3 异步通知
异步通知是比较重要的一步，在这里你可以根据通知结果处理你的业务逻辑。但是，可能会由于网络波动等原因通知不到，或者说微信接收到的响应不符合API的规定，微信会持续发起多次通知（请在回调通知接口中合理处理，避免重复通知造成业务重复处理），直到成功为止，通知频率为 `15s` / `15s` / `30s` / `3m` / `10m` / `20m` / `30m` / `30m` / `30m` / `60m` / `3h` / `3h` / `3h` / `6h` / `6h` - 总计 `24h4m` ）。但是微信不保证通知最终一定会成功。 
异步通知响应参数如下： 

 
  参数名 
  是否必传 
  类型 
  描述 
  
 
  return_code 
  是 
  返回状态码， `SUCCESS` / `FAIL` return_msg 
  否 
  返回信息 
  
 
如果微信一直通知不成功怎么？还是刚才那个例子，你明明支付成功了，但是商家却一直说她没收到钱，这时候你怎么办？肯定是去看一下她的手机是否真的没有收到钱！这里也一样。 
##### 3.4 支付状态查询

 商户APP或者前端页面收到支付返回时，商户需要调用商户查单接口确认订单状态，并把查询结果展示给用户。  
 商户后台需要准确、高效地处理微信支付发送的异步支结果通知，并按接口规范把处理结果返回给微信支付。  
 商户后台未收到异步支付结果通知时，商户应该主动调用 `微信支付查单接口` ，同步订单状态。  
 商户在T+1日从微信支付侧获取T日的交易账单，并与商户系统中的订单核对。如出现订单在微信支付侧成功，但是在商户侧未成功的情况，商户需要给用户补发货或者退款处理。  

#### 1.5 四、总结
微信支付开发文档 
如果文章写的有问题，请不要吝惜文笔，欢迎留言指出，我会及时核查修改。[Test](https://api.opics.org/api '手把手教你接入微信支付')

本文标题： 教你接入微信支付

发布时间： 2022年09月29日 00:00

最后更新： 2025年12月30日 08:54

原始链接： https://haoxiang.eu.org/2d89f11b/

版权声明： 本文著作权归作者所有，均采用CC BY-NC-SA 4.0许可协议，转载请注明出处！

赏
× 喜欢就赞赏一下呗！
打赏二维码