微信支付 V3 开发教程（一）：初识 Senparc.Weixin.TenPayV3

前言

　　我在 9 年前发布了 Senparc.Weixin SDK 第一个开源版本，一直维护至今，如今 Stras 已经破 7K，这一路上得到了 .NET 社区的积极响应和支持，也受到了非常多的宝贵建议，甚至代码的 PR，目前累计的代码贡献者数量已经超过350人，在此表示衷心的感谢！

　　我们也总在第一时间及时更新微信官方的各类接口，其中也包括微信支付。

　　如今，针对已经发布了一段时间的“微信支付V3”，我们发布了一个完全重构后的全新版本：Senparc.Weixin.TenPayV3。

　　即使您没有开发过之前版本的微信支付也没有关系，因为这是一个完全崭新的开始，下面让我们开始最新一代的微信支付开发之旅。

关于微信支付 V2 和 V3

　　从微信支付 V2 开始，我们第一时间上线了微信支付的功能，并在 2018 年正式分离出独立的 Senparc.Weixin.TenPay 作为微信支付的专用类库。

　　微信支付自诞生以来进行了多次升级，其中比较容易混淆的是 V2 和 V3 两个版本号，在继续介绍之前，必须要做一个说明：

目前社区中流传的“微信支付V3”实际上有 2  个版本的说法，一个 V3 是早期微信支付文档和接口进行了一轮升级，当时文档称其为 V3，后来又出来一个是微信支付官方对 API 的版本号进行了升级，也称其为 V3。

　后者的 V3 是真正意义上的“微信支付V3”，本次发布的模块也是针对这个 V3 而言的。

　由于历史原因，在先前发布的 Senparc.Weixin.TenPay 中也已经包含了 V2 和 V3 两个版本的命名，这里的 V3 就是早期文档的 V3，和“微信支付V3"的用法实际上有很大差别，但在功能上，基本上属于“微信支付V3”的子集。

 

快速开发-准备

　　这里，我先从宏观演示一下 Senparc.Weixin.TenPayV3 的能力，通过网页演示和单元测试，完成最简单的鉴权、支付、退款和订单拉取功能（这些功能代表了几乎所有微信支付内部接口的形式），后续的章节将继续展开细节进行介绍。

　　关于具体的接口和流程介绍，大家还是要耐心看官方的文档：产品能力概览 | 微信支付商户平台文档中心，准备好微信支付V3所需的所有配置（V3 比之前的文档已经有了很大的飞跃，照着做基本上可以顺利完成）。下面的示例将以【普通商户+微信公众号JSAPI】这个组合进行展示，其他组合功能将在后续展开介绍。

　　所有微信支付形式的 Sample 已经在开源项目中，默认使用 .NET 6 项目打开：https://github.com/JeffreySu/WeiXinMPSDK/tree/master/Samples/net6-mvc，为了方便测试，您可以直接下载或者克隆项目，机型测试，对应代码可以移植到自己的项目中。

　　下载代码并打开上述目录中的 Senparc.Weixin.Sample.Net6.sln：

 　　其中，Controller 和 Views 的命名，为了和之前已经诞生的旧版本 V3 区分，我们暂时命名为 RealV3 ：

　　不需要修改任何代码，直接运行 Senparc.Weixin.Sample.NET6 项目，即可打开 Sample 首页：

　　由于 Sample 集成了微信公众号、小程序、企业微信、微信支付，以及相关的缓存、模拟消息、文档下载等演示，所以看上去内容比较多，不用着急，Sample 配有详细的注释，并且对文件进行了分类，我们只需聚焦相关的部分。

开发第一步：引用 Nuget 包

　　Sample 项目已经引用好了源码项目，如果您是全新的项目，可以直接引用 Senparc.Weixin.TenPayV3 包。

　　方法一：使用 VS 管理器引用：

 　　方法二：直接在 .csproj 文件中引用（注意从 Senparc.Weixin.TenPayV3 网页查看最新版本）

 

 <ItemGroup>
        <PackageReference Include="Senparc.Weixin.TenPayV3" Version="0.3.500.2-preview2" />
    </ItemGroup>

开发第二步：设置微信支付信息

　　在 Web 项目下面，找到 appsettings.json 文件，设置微信公众号和微信支付信息（其他信息根据说明，不需要的可以删除，或者保留原状），默认情况下只需要修改 SenparcWeixinSetting 节点下的“公众号”和“微信支付V3（新版）”的对应信息：

"SenparcWeixinSetting