C#开发微信门户及应用微信支付接入和API封装使用

C#开发微信门户及应用微信支付接入和API封装使用
在微信的应用上，微信支付是一个比较有用的部分，但也是比较复杂的技术要点，在微商大行其道的年代，自己的商店没有增加微信支付好像也说不过去，微信支付旨在为广大微信用户及商户提供更优质的支付服务，微信的支付和安全系统由腾讯财付通提供支持。本文主要介绍如何在微信公众号上实现微信支付的接入、微信支付API的封装，以及API的调用，实现我们一些常见的业务调用。

在微信的应用上，微信支付是一个比较有用的部分，但也是比较复杂的技术要点，在微商大行其道的年代，自己的商店没有增加微信支付好像也说不过去，微信支付旨在为广大微信用户及商户提供更优质的支付服务，微信的支付和安全系统由腾讯财付通提供支持。本文主要介绍如何在微信公众号上实现微信支付的接入、微信支付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说明，我们可以分别对这些接口（如统一下单、查询订单、关闭订单、申请退款、查询退款、下载对账单等接口进行逐一封装，以方便我们的开发使用。

模式一和模式二，都需要使用到了统一下单的接口，然后生成相应的二维码给客户扫码支付使用。

那么我们先来看看统一下单的接口说明，以了解它的具体使用。

1）应用场景

除被扫支付场景以外，商户系统先调用该接口在微信支付服务后台生成预支付交易单，返回正确的预支付交易回话标识后再按扫码、JSAPI、APP等不同场景生成交易串调起支付。

2）接口链接

URL地址：https://api.mch.weixin.qq.com/pay/unifiedorder

3）是否需要证书

不需要

4）请求参数

请求参数看似很多，大概分为两部分，一部分是系统必须的固定参数，一部分是业务所需的参数。

系统必须的固定参数如下所示。

一部分是业务参数，业务参数如下所示，主要是记录订单的相关产品ID、说明、费用等等

微信支付接口的调用和公众号其他接口调用不太一样，这里全部是采用XML进行交换的，感觉没有JSON那么方便灵活，如下所示是统一下单的接口提交数据。

 

然后返回的数据也是XML的，如下面例子代码所示，而且其中的字段内容还不太确定，因此按官网的建议，使用字典集合来存储返回的数据对象。

 

3、微信支付APIC#封装和调用

根据上面的描述，我们大概了解了微信支付API 的大概说明，根据这些信息，我们可以对它进行C#代码的封装了，对于代码的封装，我们关键点在其中第一个，如果顺利封装好第一个接口，那么后面的根据通用的方式，就很容易继续处理这些接口了。

例如，我们可以定义好微信支付的API接口定义，如下所示。

/// <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);        .............