asp.net 支付宝及时到帐接口使用详解

ASP.NET支付宝及时到账接口使用详解：

概述

本文主要介绍如何使用ASP.NET集成支付宝及时到账接口，实现在线支付功能。

支付宝是国内常见的第三方支付平台之一，提供了丰富的支付接口。包括但不限于扫码支付、移动支付、Web支付、网页收银台等方式。今天我们要介绍的是ASP.NET集成支付宝即时到账接口。

开始

使用支付宝即时到账接口，需要注册成为支付宝商家，并且开通即时到账接口权限。具体可以在支付宝开发者文档中查找。

在注册完毕并获取到接口权限后，我们可以开始集成支付宝接口。

接口流程

集成支付宝即时到账接口的基本流程如下：

发送请求：构造支付请求参数并发送请求。
获取响应：支付宝处理请求并返回响应结果。
验证签名：支付宝返回的数据会带有签名字符串，我们需要验证签名是否为支付宝发送的数据。

接下来我们会对上述流程进行详细说明，并分享一些代码示例。

发送请求

构造支付请求参数时，需要将相关参数进行封装，然后以POST方式发送至支付宝API网关。如下所示：

var req = new AlipayTradePagePayRequest();
req.SetNotifyUrl("http://localhost/notify_url.aspx");
req.SetReturnUrl("http://localhost/return_url.aspx");

req.AdditionalParams.Add("extend_params", "{\"sys_service_provider_id\":\"2088511833207846\"}");
req.BizContent = "{\"body\":\"测试商品\",\"subject\":\"测试分期单\",\"out_trade_no\":\"" + out_trade_no + "\",\"total_amount\":\"" + total_fee + "\",\"product_code\":\"FAST_INSTANT_TRADE_PAY\"}";

var response = client.PageExecute(req, null, "post");

以上示例是使用了.NET的Alipay SDK需要自行添加下载Nuget包。在发送支付请求前我们需要先初始化客户端（client），然后创建支付请求（req），添加一些必须的参数，如：NotifyUrl（异步通知地址），ReturnUrl（同步通知地址），BizContent（业务内容），等等。

此外，我们也可以添加一些扩展参数，如extend_params。以上请求参数的详细说明可以在支付宝开发者文档中查看。

注意：在提交支付请求前，我们需要对BizContent进行URL Encode，以处理其中的特殊字符。否则可能会导致支付宝返回“参数错误”的结果。

获取响应

构造完请求参数后，我们需要将请求发送至支付宝网关，并等待支付宝的响应结果。

var response = client.PageExecute(request, null, "post");

我们使用.NET的Alipay SDK的PageExecute方法来发送请求，并得到响应结果。

验证签名

为了防止支付请求被篡改，支付宝会返回一个签名字符串，我们需要验证签名字符串，并确定响应数据是否可信。

使用.NET的Alipay SDK，可以通过以下方法验证签名：

var isVerify = AlipaySignature.RSACheckV1(dict, publicKey, "utf-8", "RSA2", false);

其中，参数dict是包含支付宝响应数据的键值对，publicKey为支付宝RSA公钥。如果验证成功，isVerify值为true。

示例代码

下面提供了一个完整的代码示例，展示了如何使用ASP.NET集成支付宝及时到账接口，实现在线支付功能。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using Aop.Api;
using Aop.Api.Request;
using Aop.Api.Response;
using Aop.Api.Util;

public partial class order : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (Request.HttpMethod == "POST")
        {
            // 支付宝服务器异步通知页面路径
            var notify_url = "http://localhost/notify_url.aspx";
            // 支付宝服务器同步通知页面路径
            var return_url = "http://localhost/return_url.aspx";

            // 实例化客户端
            var client = new DefaultAopClient("https://openapi.alipay.com/gateway.do", "xxxxxxx", "xxxxxxxxxxxxxxxxxxxxxxxxx", "json", "1.0", "RSA2", "xxxxxxxxxxxxxxxxxxxxxxxxxx");

            // 获取订单号和付款金额
            var orderid = Request.Form["orderid"];
            var total_fee = Request.Form["total_fee"];

            // 生成退款交易号（使用当前时间作为退款交易号）
            var refund_no = DateTime.Now.ToString("yyyyMMddHHmmssffffff");

            // 构造退款请求参数
            var req = new AlipayTradePagePayRequest();
            req.SetNotifyUrl(notify_url);
            req.SetReturnUrl(return_url);

            req.AdditionalParams.Add("extend_params", "{\"sys_service_provider_id\":\"2088511833207846\"}");
            req.BizContent = "{\"body\":\"测试商品\",\"subject\":\"测试分期单\",\"out_trade_no\":\"" + out_trade_no + "\",\"total_amount\":\"" + total_fee + "\",\"product_code\":\"FAST_INSTANT_TRADE_PAY\"}";

            // 发送请求
            var response = client.PageExecute(req, null, "post");

            // 响应处理
            Response.Clear();
            Response.Write(response.Body);
            Response.End();
        }
    }
}

在以上代码中，我们初始化了一个AlipayClient实例（client），并将其所需属性设置为合适的值。

接下来获取订单号和付款金额，并构造退款请求参数。

在完成支付请求后，我们会得到一个包含支付宝返回的签名字符串的字典，我们可以使用.NET的Alipay SDK提供的RSACheckV1方法来验证签名。

最后，我们将响应结果输出到页面中，以完成整个支付过程。