在微信的應用上，微信支付是一個比較有用的部分，但也是比較複雜的技術要點，在微商大行其道的年代，自己的商店沒有增加微信支付好像也說不過去，微信支付旨在為廣大微信用戶及商家提供更優質的支付服務，微信的支付和安全系統由騰訊財付通提供支援。本文主要介紹如何在微信公眾號上實現微信支付的接入、微信支付API的封裝，以及API的調用，實現我們一些常見的業務調用。
1、開通微信支付並配置
微信支付是需要微信公眾號的認證基礎，也就是只對認證的公眾號開放，微信認證需要簽署相關的資料，並且進行對帳認證，一般會有電話聯絡確認相關的資訊的。
在微信支付API開始使用前，我們一般需要在後台進行一定的配置，如我們需要配置公眾號支付的授權目錄，測試白名單等信息，以及掃碼支援的回調處理位址（這個實作在後面再講），如下所示。
在使用API之前，我們要知道微信一些關鍵的操作，如退款、撤銷訂單等操作是需要證書的，而且常規的支付操作，我們也需要商戶號、商家支付秘鑰等信息，這些證書和秘鑰信息，是我們從微信支付的商戶平台上獲取的，我們微信支付開通並審核通過後，我們就可以登錄商戶平台進行相關的操作了。
首先我們需要在開發的電腦上安裝憑證。
然後需要設定API的密碼金鑰
#最後在【API安全】專案上下載憑證供我們開發環境使用。
2、微信支付API的介紹
微信支付配置相關的參數，並取得憑證、API密碼、商家號等資訊後，我們可以開始了解微信支付的API的具體使用了，我們需要先把API封裝為C#的類別庫進行使用，這樣才能在各種應用裡面方便呼叫。
微信支付分為有多種方式，如掃碼支付、公眾號支付、JSAPI支付、APP支付等方面，不過核心的API都差不多，基本上都覆蓋了下面截圖的幾個API ，只是有部分的介面差異。
我們可以從其中掃碼付款開始了解，這個是對二維碼進行掃碼支付的場景，分為了模式一和模式二兩種方式。
掃碼付款可分為兩種模式，商家依照支付場景選擇對應模式。
【模式一】：商家後台系統依據微信支付規則連結產生二維碼，連結中帶固定參數productid（可定義為產品識別或訂單號）。用戶掃碼後，微信支付系統將productid和用戶唯一識別(openid)回調商戶後台系統(需要設定支付回調URL)，商戶後台系統根據productid產生支付交易，最後微信支付系統發起用戶支付流程。
【模式二】：商家後台系統呼叫微信支付【統一下單API】產生預付交易，將介面回傳的連結產生二維碼，用戶掃碼後輸入密碼完成支付交易。注意：此模式的預付單有效期限為2小時，過期後無法支付。
根據掃碼支付的API說明，我們可以分別對這些介面（如統一下單、查詢訂單、關閉訂單、申請退款、查詢退款、下載對帳單等介面進行逐一包裝，以方便我們的開發使用。先來看看統一下單的介面說明，以了解它的具體使用。
##除被掃支付場景以外，商家系統先呼叫該介面在微信支付服務後台產生預付交易單，回傳正確的預付交易回話標識後再按掃碼、JSAPI、APP等不同場景產生交易串調起付款。
2）介面連結
URL位址：https ://api.mch.weixin.qq.com/pay/unifiedorder
#3）是否需要憑證
請求參數看似很多，大概分成兩個部分，一部分是系統必須的固定參數，一部分是業務所需的參數。
系統必須的固定參數如下所示。
有一部分是業務參數，業務參數如下所示，主要是記錄訂單的相關產品ID、說明、費用等等
然後傳回的資料也是XML的，如下面範例程式碼所示，而且其中的欄位內容還不太確定，因此按官網的建議，使用字典集合來儲存傳回的資料對象。
3、微信支付APIC#封裝和呼叫
/// <summary>
/// 微信支付接口
/// </summary>
public interface ITenPayApi
{
/// <summary>
/// 生成扫描支付模式一URL
/// </summary>
/// <param>商品ID
/// <returns></returns>
string GetPrePayUrl(string productId);
/// <summary>
/// 生成直接支付url，支付url有效期为2小时,模式二
/// </summary>
/// <param>商品订单数据
/// <returns></returns>
string GetPayUrl(WxPayOrderData info);
/// <summary>
/// 统一下单。（不需要证书,默认不需要）
/// 除被扫支付场景以外，商户系统先调用该接口在微信支付服务后台生成预支付交易单，
/// 返回正确的预支付交易回话标识后再按扫码、JSAPI、APP等不同场景生成交易串调起支付。
/// </summary>
/// <param>商品订单数据
WxPayData UnifiedOrder(WxPayOrderData info);
.............
其中的介面方法的輸入參數我們定義一個實體類別 
/// <summary>
/// 统一下单的商品订单信息
/// </summary>
public class WxPayOrderData
{
/// <summary>
/// 商品ID, trade_type=NATIVE，此参数必传
/// </summary>
public string product_id { get; set; }
/// <summary>
/// 商品或支付单简要描述
/// </summary>
public string body { get; set; }
/// <summary>
/// 订单总金额，单位为分
/// </summary>
public int total_fee { get; set; }
/// <summary>
/// 商品标记，代金券或立减优惠功能的参数，说明详见代金券或立减优惠
/// </summary>
public string goods_tag { get; set; }
/// <summary>
/// 交易类型,默认为:NATIVE。
/// JSAPI--公众号支付、NATIVE--原生扫码支付、APP--app支付
/// </summary>
public string trade_type { get; set; }
/// <summary>
/// 商品名称明细列表
/// </summary>
public string detail { get; set; }
/// <summary>
/// 附加数据
/// 在查询API和支付通知中原样返回，该字段主要用于商户携带订单的自定义数据
/// </summary>
public string attach { get; set; }
/// <summary>
/// 用户标识
/// trade_type=JSAPI，此参数必传，用户在商户appid下的唯一标识。
/// </summary>
public string openid { get; set; }
public WxPayOrderData()
{
this.trade_type = "NATIVE";
}
}
#然後我們定義一個介面傳回的類別WxPayData，它用來儲存回傳的物件資訊的，這個類別在官網例子裡面有說明，其裡面內置一個排序過的字典對象進行存儲數據，部分代碼如下所示，我對它進行了相關的修改，以方便在構造函數裡面初始化一些必備的參數（固定參數）。
public class WxPayData
{
//采用排序的Dictionary的好处是方便对数据包进行签名，不用再签名之前再做一次排序
private SortedDictionary<string> m_values = new SortedDictionary<string>();
/// <summary>
/// 默认构造函数
/// 如果initDefault为true，则自动填入字段（appid,mch_id,time_stamp,nonce_str,out_trade_no,）
/// </summary>
public WxPayData(bool initDefault = false)
{
if(initDefault)
{
Init();
}
}
/// <summary>
/// 对象初始化后，自动填入字段（appid,mch_id,time_stamp,nonce_str,out_trade_no,）
/// </summary>
public void Init()
{
//初始化几个参数
this.SetValue("appid", WxPayConfig.APPID);//公众帐号id
this.SetValue("mch_id", WxPayConfig.MCHID);//商户号
this.SetValue("nonce_str", GenerateNonceStr());//随机字符串
this.SetValue("out_trade_no", GenerateOutTradeNo(WxPayConfig.MCHID));//随机字符串
}</string></string>
然後我們根據上面的資料定義，可以實現統一下單的函數內容，主要是把輸入參數轉換成我們需要的字典參數集合，如下程式碼所示。
/// <summary>
/// 统一下单。（不需要证书,默认不需要）
/// 除被扫支付场景以外，商户系统先调用该接口在微信支付服务后台生成预支付交易单，
/// 返回正确的预支付交易回话标识后再按扫码、JSAPI、APP等不同场景生成交易串调起支付。
/// </summary>
/// <param>商品订单数据
public WxPayData UnifiedOrder(WxPayOrderData info)
{
WxPayData data = new WxPayData(true);
data.SetValue("product_id", info.product_id);//商品ID
data.SetValue("openid", info.openid);//商品ID
//其他信息
data.SetValue("body", info.body);//商品描述
data.SetValue("attach", info.attach);//附加数据
data.SetValue("total_fee", info.total_fee);//总金额
data.SetValue("goods_tag", info.goods_tag);//商品标记
data.SetValue("trade_type", info.trade_type);//交易类型
//默认构建
data.SetValue("time_start", DateTime.Now.ToString("yyyyMMddHHmmss"));//交易起始时间
data.SetValue("time_expire", DateTime.Now.AddMinutes(10).ToString("yyyyMMddHHmmss"));//交易结束时间
..............
最後的資料交換邏輯，我們透過對URL進行POST提交XML資料給它取得回傳結果就可以了，如下所示。
string url = "https://api.mch.weixin.qq.com/pay/unifiedorder"; return GetPostResult(data, url);
其中上面的函数的代码逻辑如下所示，主要是把返回的结果再还原为XML对象类WxPayData。
/// <summary>
/// 通用的获取结果函数
/// </summary>
private WxPayData GetPostResult(WxPayData data, string url)
{
string xml = data.ToXml();
string response = helper.GetHtml(url, xml, true);
WxPayData result = new WxPayData();
result.FromXml(response);
return result;
}
对于扫码操作的模式二，直接生成一种二维码，不需要后台进行回调的，那么它的实现逻辑只需要对上面代码进行封装就可以了，如先构建二维码的函数代码如下所示。
/// <summary>
/// 生成直接支付url，支付url有效期为2小时,模式二
/// </summary>
/// <param>商品订单数据
/// <returns></returns>
public string GetPayUrl(WxPayOrderData info)
{
WxPayData result = UnifiedOrder(info);//调用统一下单接口
return result.GetString("code_url");//获得统一下单接口返回的二维码链接
}
如在Winform界面里面，调用生成二维码的代码如下所示，主要逻辑就是构建好二维码，然后显示在界面上。
private void btnGetPayUrl_Click(object sender, EventArgs e)
{
//测试扫码模式二的生成二维码方式
WxPayOrderData data = new WxPayOrderData()
{
product_id = "123456789",
body = "测试支付-模式二",
attach = "爱奇迪技术支持",
detail = "测试扫码支付-模式二",
total_fee = 1,
goods_tag = "test1"
};
var url = api.GetPayUrl(data);
var image = api.GenerateQRImage(url);
this.imgGetPayUrl.Image = image;
this.imgGetPayUrl.SizeMode = PictureBoxSizeMode.StretchImage;
}
另外对于模式一，它在前端传入一个简单的产品ID，生成二维码，当用户扫码的时候，微信后台会调用商户平台（我们服务器）的回调处理方法，这个回调方法会调用统一下单的API进行生成支付交易，过程有点复杂，我们来看看，我们的实现代码如下所示。
/// <summary>
/// 生成扫描支付模式一URL
/// </summary>
/// <param>商品ID
/// <returns></returns>
public string GetPrePayUrl(string productId)
{
WxPayData data = new WxPayData(true);
data.SetValue("product_id", productId);//商品ID
data.SetValue("time_stamp", data.GenerateTimeStamp());//随机字符串
data.SetValue("sign", data.MakeSign());//签名
string str = data.ToUrlParams();//转换为URL串
string url = "weixin://wxpay/bizpayurl?" + str;
return url;
}
它的调用代码生成二维码操作如下所示。
private void btnGetPrePayUrl_Click(object sender, EventArgs e)
{
var productId = "12345678";
var url = api.GetPrePayUrl(productId);
var image = api.GenerateQRImage(url);
this.imgGetPrePayUrl.Image = image;
this.imgGetPayUrl.SizeMode = PictureBoxSizeMode.StretchImage;
}
我们在第一小节里面介绍了，需要在微信后台配置扫码的回调函数，如下所示。
这样我们还需要添加一个页面aspx、或者一般处理程序ashx的方式来实现扫码的回调过程。具体的逻辑也就是在这个页面里面获取到提交过来的参数，然后调用统一下单处理后，进行数据返回即可，代码逻辑如下所示。
4、在页面上进行扫码处理
前面的例子，我介绍了Winfrom的扫码例子，很多时候，我们的应用可能是基于Web的，那么它的实现是如何的呢，下面我继续介绍一下。
首先我们在自己的业务Web后台系统里面，添加两个页面，主要是用来生成二维码在页面上进行展示的，如下所示。
最终我们在NativePayPage.aspx页面上展示我们的二维码，方便用户进行扫码支付处理，页面的代码很简单，我们只需要在前端页面放置两个图片控件，图片内容通过MakeQRCode.aspx页面进行生成就可以了。
nbsp;html> <meta> <meta> <title>微信支付样例-扫码支付</title> <div>扫码支付模式一</div><br> <image></image> <br><br><br> <div>扫码支付模式二</div><br> <image></image>
页面后台的代码就是绑定二维码的过程，代码如下所示，和Winform的代码类似操作。
protected void Page_Load(object sender, EventArgs e)
{
TenPayApi api = new TenPayApi();
var productId = "123456789";
//生成扫码支付模式一url
string url1 = api.GetPrePayUrl(productId);
//生成扫码支付模式二url
WxPayOrderData info = new WxPayOrderData()
{
product_id = "123456789",
body = "测试支付-模式二",
attach = "爱奇迪技术支持",
detail = "测试扫码支付-模式二",
total_fee = 1,
goods_tag = "test1"
};
string url2 = api.GetPayUrl(info);
//将url生成二维码图片
Image1.ImageUrl = "MakeQRCode.aspx?data=" + HttpUtility.UrlEncode(url1);
Image2.ImageUrl = "MakeQRCode.aspx?data=" + HttpUtility.UrlEncode(url2);
}
实现后的页面效果如下所示。
实现并预览效果，确定是我们所需的页面后，我们可以发布在公众号的菜单连接上进行测试使用了。
打开微信公众号-广州爱奇迪，我们可以看到对应的菜单发生改变，并且看到进入微信支付的菜单可以进行支付了。
以上就是微信支付的掃碼過程的一個實現，微信支付還包括很多其他API接口，後面有機會可以繼續介紹。微信支付的介面實作雖然相對其他微信介面比較複雜一些，但是我們一旦完成幾個案例，後面的就相對比較容易的了，因為它的呼叫方式基本上比較一致，很類似。
更多C#開發微信入口網站及應用微信支付存取與API封裝使用相關文章請關注PHP中文網！
熱AI工具
Undresser.AI Undress
人工智慧驅動的應用程序，用於創建逼真的裸體照片
AI Clothes Remover
用於從照片中去除衣服的線上人工智慧工具。
Undress AI Tool
免費脫衣圖片
Clothoff.io
AI脫衣器
Video Face Swap
使用我們完全免費的人工智慧換臉工具，輕鬆在任何影片中換臉！
熱門文章
熱工具
EditPlus 中文破解版
體積小，語法高亮，不支援程式碼提示功能
SublimeText3漢化版
中文版，非常好用
WebStorm Mac版
好用的JavaScript開發工具
ZendStudio 13.5.1 Mac
強大的PHP整合開發環境
SublimeText3 Mac版
神級程式碼編輯軟體(SublimeText3)
