Wechat is the most famous IM APP in China which has more than 1 billion active users and more than ten million Official Accounts.
By using Senparc.Weixin SDK, you can develop all wechat platform applications, including Official Account, Mini Programm, Mini Game, Enterprise Account, Open Platform, Wechat Pay, JS-SDK, Wechat IoT/Bluetooth, etc.
Now, Senparc.Weixin has been supported almost all of the API for Wechat's all modules. It supports mutipule .Net targets .NET 3.5 / 4.0 / 4.5 / .NET Standard 2.x / .NET Core 2.x / .NET Core 3.x / .NET 6.0.
Senparc.Weixin SDK is the most widly used .NET Wechat SDK. Also it is one of the most popular .NET open source project in China.
For more than 10 years, we have been keeping the project constantly updated, share the complete source code and design ideas without reservation. Hopefully more people will benefit from it, understand and disseminate the spirit of open source. Grateful to the friends who helped us along the way!
If you like and hope us to continue to optimize this project, please give us a Star:)
🏆 《2020-2021 Outstanding Contributors of Senparc Developer Community Shortlist》 has been published. Please check and register the information before 13/9/2021 10:24 AM 😄
🔒 TenPay V3 Module has been released！
⚡ Sample has already supported for .NET 6.0, Click Here !
🍦 file.api.weixin.qq.com Domain name officially disabled(2020.9.15), please update to the latest version!
| Module | URL |
|---|---|
| Official Accounty (MP) | https://sdk.weixin.senparc.com/Docs/MP/ |
| Mini Program (WxOpen) | https://sdk.weixin.senparc.com/Docs/WxOpen/ |
| Entripise Account (Work) | https://sdk.weixin.senparc.com/Docs/Work/ |
| TenPay V3 (Recommended) | https://sdk.weixin.senparc.com/Docs/TenPayV3/ |
| TenPay V2 (Not Recommended) | https://sdk.weixin.senparc.com/Docs/TenPayV2/ |
- SDK Modules
- Personalize your WeChat project Sample
- Resources
- 📖 Senparc official tutorials
- Contribute Code
- Develop with .net Core
- Follow Demo Official Account(SenparcRobot)
- Project folder description (under src folder)
- Sample folder description (under Samples folder)
- Senparc.Weixin.MP.Sample Key Code
- Use Nuget to install the project
- How to develop Mini Program?
The library contains the source code (the Core logic is exactly the same) that includes .Net 3.5/4.0/4.5/.NET Standard 2.0/.NET Core/.NET 6/.NET 7.
- Use Visual Studio 2022 open Demo(support for all .NET Versions)：.NET 7.0 - Senparc.Weixin.Sample.Net7.sln (referenced source code, recommanded)
- Use other versions of Visual Studio to open the Demo (support .net 4.5 only) : Senparc.Weixin.MP.Sample.sln
- Use Visual Studio 2019 to open Console Demo（.NET Core）：Senparc.Weixin.MP.Sample.Consoles.vs2019.sln
| # | Module Libraries | DLL | Nuget | Support .NET Versions |
|---|---|---|---|---|
| 1 | Base Library | Senparc.Weixin.dll |  |
    |
| 2 | Official Account / JSSDK ect. |
Senparc.Weixin.MP.dll |   |
|
| 3 | Mini Program (s.p. Mini Game) (indep. proj.) |
Senparc.Weixin.WxOpen.dll |   |
|
| 4 | Tencent Pay(TenPay) | Senparc.Weixin.TenPay.dll |   |
|
| 5 | Tencent Pay(TenPay) V3 | Senparc.Weixin.TenPayV3.dll |   |
 |
| 6 | ASP.NET MVC Extension | Senparc.Weixin.MP.MVC.dll |   |
|
| 7 | Corporate Account | Senparc.Weixin.QY.dll |   |
|
| 8 | Corporate Wechat | Senparc.Weixin.Work.dll |   |
|
| 9 | Open Platform | Senparc.Weixin.Open.dll |   |
|
| 10 | Redis Distributed Cache | Senparc.Weixin.Cache. Redis.dll |
  |
|
| 11 | Memcached Distributed Cache |
Senparc.Weixin.Cache. Memcached.dll |
  |
|
| 12 | WebSocket (indep. proj.) |
Senparc.WebSocket.dll |   |
|
|
|
|
|
|---|---|---|---|
| .NET 4.6.2 | .NET Standard 2.0 / 2.1 | .NET Core 2.x / 3.x | .NET 5.0 / .NET 6.0 / .NET 7.0 |
Tip:
last stable release click here (minimum .NET 4.5.1 support from November 7, 2021), since May 1, 2019 to stop updating.
- The .NET Framework 4.5 update is scheduled to end on December 31, 2024. It's strongly advice you to use .NET 3.1 or .NET 6.0+ for new projects.
If you are still using .NET Framework, it is recommended that upgrade .NET Framework applications to .NET Framework 4.8+ before January 12, 2027, when .NET Framework 4.6.2 will be officially stopped Support ([see more] (https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-framework))
- Supported all Wechat 8.x APIs, includes customize menu / personalized menu, template message, material APIs, group message, multi-customer service, TenPay, MerChant, cards APIs, ect.
- Supported Wechat Official Account, MiniProgram, MiniProgram-Game, Enterpaise Account, Open Platform modules.
- Supported user dialogue context, to solve application service can not use Session to handle users' dialogues.
- Fully supported latest APIs for Wechat Official Account, Corporate Account(Corporate Wechat), TenPay V2/V3, Open Platform.
- Supported Distributed Cache Strategy with high scalability.
All updates will ensure downward compatibility unless otherwise specified. So you can cover new DLLs directly or use Nuget to manage packages(highly recommend).
Web version：view course。
Notice: using the WeChatSampleBuilder tool simply makes it easier for you to test and learn the Sample code, not to generate a complete production environment project. If you need to build a production environment project, refer to the full Demo or other tutorials. It is recommended to use an existing system framework, such as NeuCharFramework.
- Senparc.Weixin SDK Official Site: https://weixin.senparc.com/
- Online Demo Site：https://sdk.weixin.senparc.com/
- Blog tutorial: https://www.cnblogs.com/szw/archive/2013/05/14/weixin-course-index.html
- WeChat technology exchange community: https://weixin.senparc.com/QA
- Online editing tool for Customize menu: https://sdk.weixin.senparc.com/Menu
- Online test tool for Messages: https://sdk.weixin.senparc.com/SimulateTool
- Online test tool for Cache：https://sdk.weixin.senparc.com/Cache/Test
- chm documentation download：https://sdk.weixin.senparc.com/Document
- Source code and the latest updates : https://github.com/JeffreySu/WeiXinMPSDK
- WeChat development resources: https://github.com/JeffreySu/WeixinResource
- Depth Analysis of WeChat Development reading system：https://book.weixin.senparc.com
- Buy Depth Analysis of WeChat Development：https://item.jd.com/12220004.html
- Video Course：https://github.com/JeffreySu/WechatVideoCourse
- Technical communication QQ group:
5th group(Official Account): 377815480 14th Group(Video Course Student Group)：588231256
(Official Account): 289181996
10th Group(Distributed Cache): 246860933
12th Group(Mini Program): 108830388
16h Group(Open Platform): 860626938
the following groups are full:
1st group：300313885(full)，2nd group：293958349(full)，3rd group：342319110(full)
4th group：372212092(full)，6th group：425898825(full)
7th group：482942254(full)，8th group：106230270(full)，9th group：539061281(full)
11th group：553198593(full)，13th group: 183424136(full)，15th Group：289181996（full)
- Business contact QQ：498977166
If this project is useful to you, we welcome any form of donations from all parties, including participation in project code updates or feedback. Thank you!
donate: Enter
By Jeffrey Su and Senparc team took 2 years to complete the development of WeChat book have been published, the book's full name is: Depth Analysis of WeChat Development: the efficient development of the Official Account and Mini Program, the auxiliary reading system has been on the line: BookHelper。
Welcome to buy genuine books:【Buy】
The branch of code snapshot for the book published version BookVersion1。
| Senparc Helper Official Account | Senparc Helper Mini-Program | BookHelper |
|---|---|---|
 |
 |
 |
Current branch including .NET Framework 4.5 / 4.6.1 及 .NET Core 2.0 + 2.1 / .NET 5.0 + 6.0 full version codes. For the assembly which has been stoped update version, please see snapshot release.
.NET Framework 4.5 Demo under/src/Samples/All/net45-mvcdirectory,
.NET 6.0 (backward compatibility with.NET 5.0 and.NET Core 3.1 and lower versions) Demo under/Samples/All/net6-mvcdirectory.
Attention: in the above Samples, the Sample in 'net6-MVC' directly references the source code of each module, which can be compiled with 'Release' to generate a compatible SDK library for different versions of Senaprc.Weixin SDK.
All of the following introduction use the example of the .NET Framework 4.5.
If you need to use or modify the program source code, recommended to Fork. We also welcome you to modify the generic version of Pull Request.
- Fork
- Create your own branch (
git checkout -b my-new-feature) - Submit your changes (
git commit -am'Added some feature') - Submit modify records to a remote warehouse (
git push origingitmy-new-feature) - And then go to the
my-new-featurebranch of thegiton GitHub site, launch Pull Request (Please refer toDeveloperbranch, not directly submitted to themasterbranch)
| Folder | Description |
|---|---|
| Senparc.WebSocket | WebSocket Module |
| Senparc.Weixin.Cache | Senparc.Weixin.Cache.Memcached.dll 、 Senparc.Weixin.Cache.Redis.dll Distributed Cache extension solutions |
| Senparc.Weixin.AspNet | Senparc.Weixin.AspNet.dll library support for Web project |
| Senparc.Weixin.MP.MvcExtension | Senparc.Weixin.MP.MvcExtension.dll source code, extension for ASP.NET MVC |
| Senparc.Weixin.MP | Senparc.Weixin.MP.dll, Official Account SDK source code |
| Senparc.Weixin.MP.Middleware | Senparc.Weixin.MP.Middleware.dll,Official Account Middleware source code |
| Senparc.Weixin.Open | Senparc.Weixin.Open.dll, 3rd Open Platform SDK source code |
| Senparc.Weixin.QY | Senparc.Weixin.QY.dll, Corporate Account SDK source code |
| Senparc.Weixin.Work | Senparc.Weixin.Work.dll Corporate Wechat SDk source code |
| Senparc.Weixin.Work.Middleware | Senparc.Weixin.Work.Middleware.dll Corporate Wechat Middleware source code |
| Senparc.Weixin.WxOpen | Senparc.Weixin.WxOpen.dll Mini Program SDK source code. Include Mini Game. |
| Senparc.Weixin.WxOpen.Middleware | Senparc.Weixin.WxOpen.Middleware.dll Mini Program Middleware source code. |
| Senparc.Weixin | all Senparc.Weixin.[x].dll base library source code |
| Folder | Description | SDK Library Reference |
|---|---|---|
| MP | Official Account Sample | Source Code |
| TenPayV2 | Tencent Payment V1 & V2 Sample | Source Code |
| TenPayV3 | Tencent Payment V3（TenPay APIv3） Sample | Source Code |
| Work | Enterprice Account Sample | Source Code |
| WxOpen | Mini-Program Sample | Source Code |
| Shared | All Sample's common shared files | |
| All | Including integration of all subordinate modules: Official Account, Mini-Program, Enterprice Account, Tencent Payment(V2 & V3 & APIv3). Recommended project references for integrating multiple platforms (advanced references) |
|
| ┣ All/net45-mvc | Demo, can be released directly(.NET Framework 4.5 + ASP.NET MVC) | Nuget Packages |
| ┣ All/console | Console Demo（.NET Core） | Source Code |
| ┗ All/net6-mvc | Demo, can be released directly(.NET 6.0), compatible with .NET 5.0 and .NET Core | Source Code |
Note: This is MVC projct, you can learn corresponding file in WebForm project.
The following Token needs to be synchronized with the Token synchronization in the background Settings of the WeChat Official Account Site(https://mp.weixin.qq.com). You can set the Token string in database or config file like Web.cofing. It's strongly recommend to use complex string, because the request is easy to forge while the Token is cracked.
public readonly string Token = "weixin";The following Action (Get) is used to receive and return the validation results of the WeChat background Url without any changes. Address such as http://domain/Weixin or http://domain/Weixin/Index
/// <summary>
/// WeChat background validation Url (Get request), such as http://weixin.senparc.com/weixin
/// </summary>
[HttpGet]
[ActionName("Index")]
public ActionResult Get(PostModel postModel, string echostr)
{
if (CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token))
{
return Content(echostr); //返回随机字符串则表示验证通过
}
else
{
return Content("failed:" + postModel.Signature + ","
+ MP.CheckSignature.GetSignature(postModel.Timestamp, postModel.Nonce, Token) + "。" +
"If you see this message in browser, that means this url address can be used in Wechat Official Account background setting for validation Url. Please note that the Token is consistent.");
}
}In above methods, PostModel is an entity including Signature, Timestamp, Nonce (by WeChat server via the incoming request Url parameter), AppId and Token, EncodingAESKey and a series of internal sensitive information (need to pass it in) entity class. PostModel also used in the rear.
The following Action (Post) used to receive Post request from WeChat server (usually initiated by the user), if necessary, here before you Get only provide WeChat background save Url validation, every Post must revalidate, otherwise it's easy to forge the request.
/// <summary>
/// After the user sends the message, the WeChat platform automatically posts a request to this place and waits for the response XML
/// </summary>
[HttpPost]
[ActionName("Index")]
public ActionResult Post(PostModel postModel)
{
if (!CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token))
{
return Content("Parameter error!");
}
...
}Senparc.Weixin.MP provides two ways to process requests, traditional methos and MessageHandler (recommended).
The above two methods have been described in more detail in the wiki, which is a simple example of the MessageHandler method.
The MessageHandler process is very simple:
[HttpPost]
[ActionName("Index")]
public ActionResult Post(PostModel postModel)
{
if (!CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token))
{
return Content("Parameter error!");
}
postModel.Token = Token;
postModel.EncodingAESKey = EncodingAESKey;//Be consistent with your Settings in the background
postModel.AppId = AppId;//Be consistent with your Settings in the background
var messageHandler = new CustomMessageHandler(Request.InputStream, postModel);//Receive messages (first step)
messageHandler.Execute();//Processing (step 2)
return new FixWeixinBugWeixinResult(messageHandler);//Return (step 3)
}In addition to the postModel assignment, the receipt (step 1), processing (step 2), and return (step 3) will only need one line of code.
CustomMessageHandler in the code above is a custom class that inherits from Senparc.Weixin.MP.MessageHandler.cs. MessageHandler is an abstract class that contains the request perform a variety of different types of abstract methods (such as text, voice, location, pictures, etc.), we only need to create your own CustomMessageHandler in each of these methods is implemented.The newly built CustomMessageHandler.cs is as follows:
using System;
using System.IO;
using Senparc.Weixin.MP.MessageHandlers;
using Senparc.Weixin.MP.Entities;
namespace Senparc.Weixin.MP.Sample.CustomerMessageHandler
{
public class CustomMessageHandler : MessageHandler<MessageContext>
{
public public CustomMessageHandler(Stream inputStream, PostModel postModel, int maxRecordCount = 0)
: base(inputStream, postModel, maxRecordCount)
{
}
public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage)
{
//ResponseMessageText can also be other types like News
var responseMessage = CreateResponseMessage<ResponseMessageText>();
responseMessage.Content = "This message is from DefaultResponseMessage。";
return responseMessage;
}
public override IResponseMessageBase OnTextRequest(RequestMessageText requestMessage)
{
//...
}
public override IResponseMessageBase OnVoiceRequest(RequestMessageVoice requestMessage)
{
//...
}
//More OnXX methods that are not overridden will return the result in DefaultResponseMessage by default.
....
}
}OnTextRequest and OnVoiceRequest correspond to different request types, such as receiving text and voice.
For example, we need to respond to text type requests, just perfect the OnTextRequest method:
public override IResponseMessageBase OnTextRequest(RequestMessageText requestMessage)
{
//TODO: the logic can be dealt with to the Service details, reference OnLocationRequest method or /Service/LocationSercice.cs
var responseMessage = CreateResponseMessage<ResponseMessageText>();
responseMessage.Content = string.Format("You just sent the message：{0}", requestMessage.Content);
return responseMessage;
}In this way, when the CustomMessageHandler executes the Messagehandler.execute(), it will automatically call the above code and return the ResponseMessage in the code to return the information if it finds that the type of the request information is Text. ResponseMessage can be any type under the IResponseMessageBase interface (including text, news, multimedia, etc.).
Starting with v0.4.0, the MessageHandler adds support for user Session context, which can be used to resolve defects on the server that can't use Session to manage user sessions. Details：User context WeixinContext and MessageContext
-
Nuget Address: https://www.nuget.org/packages/Senparc.Weixin.MP
-
Package Manager Command:
PM> Install-Package Senparc.Weixin.MP
Senparc.Weixin.WxOpen encapsulates the message and API of WeChat mini programs, keeping the development process of the Official Account request consistent. This module also support Mini Game.
-
Nuget Address: https://www.nuget.org/packages/Senparc.Weixin.WxOpen
-
Package Manager Command:
PM> Install-Package Senparc.Weixin.WxOpen
Senparc.Weixin.MP.MVC has done more optimization for ASP.NET MVC project, including convenient browser environment judgment, official bug fix, etc.
-
Nuget Address: https://www.nuget.org/packages/Senparc.Weixin.MP.MVC
-
Package Manager Command:
PM> Install-Package Senparc.Weixin.MP.MVC
Senparc.Weixin.QY.dll for Corporate Account encapsulation were conducted for the relevant functions, operation process remain the same with WeChat Official Account SDK (Senparc.Weixin.MP) .
-
Nuget Address: https://www.nuget.org/packages/Senparc.Weixin.QY
-
Package Manager Command:
PM> Install-Package Senparc.Weixin.QY
Note: QY has been stopped updating with the WeChat Corporate Account and has been seamlessly ported to Work (Corporate WeChat).
Senparc.Weixin.Work.dll for Corporate Wechat encapsulation were conducted for the relevant functions, operation process remain the same with WeChat Official Account SDK (Senparc.Weixin.MP) and WeChat Corporate Account (Senparc.Weixin.QY.dll).
-
Nuget Address: https://www.nuget.org/packages/Senparc.Weixin.Work
-
Package Manager Command:
PM> Install-Package Senparc.Weixin.Work
Senparc.Weixin.Open.dll is encapsulatied all Open Platform APIs , message operation process remain the same with WeChat Official Account SDK (Senparc.Weixin.MP), some other special message process please read the official document, then compares Demo in the Senparc.Weixin.MP.Sample project.
-
Nuget Address: https://www.nuget.org/packages/Senparc.Weixin.Open
-
Package Manager Command:
PM> Install-Package Senparc.Weixin.Open
Senparc. Weixin SDK provides the perfect caching policy interface, use the default native cache implementation, it also provides a Redis and Memcached expansion plans, you can also add your own caching strategies according to the same rules.
- Redis Cache Extension package Nuget address：https://www.nuget.org/packages/Senparc.Weixin.Cache.Redis
- Package Manager Command:
PM> Install-Package Senparc.Weixin.Senparc.Weixin.Cache.Redis
- Memcached Cache Extension package Nuget address：https://www.nuget.org/packages/Senparc.Weixin.Cache.Memcached
- Package Manager Command:
PM> Install-Package Senparc.Weixin.Senparc.Weixin.Cache.Memcached
The back-end architecture of the mini program is highly consistent with the Official Account, Only use the Nuget installationSenparc.Weixin.WxOpen to start your Mini Program develop.
Senparc.Weixin.WxOpen currently contains all the information processing, AccessToken management, template message, QR code generation, etc.
Welcome developers to Pull Request for modules that are not completed or need to be added.
| Branch | Description |
|---|---|
| master | Officially published main branch, usually this branch is stable, can be used in production environment. |
| Developer | 1, development branch, the branch for the Beta version, usually we submit the new version to this branch first, the stable version will push to the master branch. If you want to sneak peek in new function, you can use this branch. 2, this branch is compatible with the.net 4.5 /.net core /.net core 2.0 version, and it is recommended that Pull Request to this branch, not master |
| BookVersion1 | this branch is code snapshot for book Depth Analysis of WeChat Development . | DotNET-Core_MySQL | this branch shows the integration with Pomelo.EntityFrameworkCore.MySql in .NET Core environment. | NET4.0 | Support for .Net 4.0 only, this branch has stopped updating in 2017. The latest code of .Net 4.0 is updated with the master/Developer branch
| NET3.5 | Support for.Net 3.5 only, which stopped updating in 2015. The latest code is updated with the master/Developer branch | Developer-Senparc.SDK | This branch is used only for the Senparc team internal test, you can ignore this one.
Thanks to the developers who have contributed to this project, you have not only perfected this project, but also made a contribution to Open Source Enterprise. Thank you! Click Here to see the list.
If this project is useful to you, we welcome any form of contributions, including participation in project code updates or feedback.Thank you!
Donate:
Apache License Version 2.0
Copyright 2023 Jeffrey Su & Suzhou Senparc Network Technology Co.,Ltd.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file
except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the
License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
either express or implied. See the License for the specific language governing permissions
and limitations under the License.
Detail: https://github.com/JeffreySu/WeiXinMPSDK/blob/master/license.md