支付宝退款和结果查询接口简单实现（.Net 7.0）

〇、前言

支付宝对 .Net 的支持还是比较充分的，在每个接口文档中都有关于 C# 语言的示例，这样就大大降低了对接的难度，很容易上手。

官方接口文档地址：退款-alipay.trade.refund  退款状态查询-alipay.trade.fastpay.refund.query 

本文就简单实现下这两个接口，并顺便记录特别注意的点。

一、接入准备

1.1 引入 SDK

安装支付宝开放平台官方 SDK：AlipaySDKNet.Standard。基于.Net Standard 2.0开发，支持.Net Framework 4.6.1、.Net Core 2.0及其以上版本。

NuGet 简介地址：https://www.nuget.org/packages/AlipaySDKNet.Standard/

1.2 必要账户基础信息

名称	示例
应用 ID	2024 ... ...	（15 位纯数字）
应用公钥	MIIBIjANBgkqhk ... ...	（392 位）
应用私钥	MIIEvgIBADANBgk ... ...	（PKCS1 格式的 1592 位）

注意：通过支付宝密钥工具生成的应用私钥默认是 PKCS8 格式的，仅适用于 Java，此时必须手动转换成 PKCS1 格式，适用于其他全部语言。

密钥工具下载地址：https://opendocs.alipay.com/common/02kipk

如下格式转换，下边为转换后的格式以及标注：

二、接口调用

2.1 公用配置方法

将固定的应用信息填入，此方法可在不同接口中公用：

private static AlipayConfig GetAlipayConfig()
{
    string privateKey  = "<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->";
    string alipayPublicKey = "<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->";
    AlipayConfig alipayConfig = new AlipayConfig();
    alipayConfig.ServerUrl = "https://openapi.alipay.com/gateway.do";
    alipayConfig.AppId = "<-- 请填写您的AppId，例如：2019091767145019 -->";
    alipayConfig.PrivateKey = privateKey;
    alipayConfig.Format = "json";
    alipayConfig.AlipayPublicKey = alipayPublicKey;
    alipayConfig.Charset = "UTF-8";
    alipayConfig.SignType = "RSA2";
    return alipayConfig;
}

2.2 退款接口

以下是退款接口的代码，其中入参仅示例了必要的字段，其他详情见官方文档。

// 初始化SDK
IAopClient alipayClient = new DefaultAopClient(GetAlipayConfig());
// 构造请求参数以调用接口
AlipayTradeRefundRequest request = new AlipayTradeRefundRequest();
AlipayTradeRefundModel model = new AlipayTradeRefundModel();

// 设置查询选项
List<String> queryOptions = new List<String>();
queryOptions.Add("refund_detail_item_list");
model.QueryOptions = queryOptions;

//// 设置商户订单号（与支付宝交易号，配置任一即可）
//model.OutTradeNo = "20150320010101001";
// 设置支付宝交易号
model.TradeNo = "2024072900000000000000000001";

// 设置退款金额，单位为：元
model.RefundAmount = "0.01";

// 设置退款原因说明
model.RefundReason = "正常退款0729";

// 设置退款请求号
model.OutRequestNo = $"ZFB{DateTime.Now.ToString("yyyyMMddHHmmssffffff")}";

request.SetBizModel(model);
AlipayTradeRefundResponse response = alipayClient.Execute(request);
if (!response.IsError)
{
    Console.WriteLine("调用成功");
}
else
{
    Console.WriteLine("调用失败");
}

成功返回：

{
	"alipay_trade_refund_response": {
		"code": "10000",
		"msg": "Success",
		"buyer_logon_id": "188******10",
		"fund_change": "Y",
		"gmt_refund_pay": "2024-07-29 13:50:04",
		"out_trade_no": "*****",
		"refund_detail_item_list": [
			{
				"amount": "0.01",
				"fund_channel": "COUPON"
			}
		],
		"refund_fee": "0.01",
		"send_back_fee": "0.01",
		"trade_no": "*****",
		"buyer_open_id": "*****"
	},
	"sign": "*****"
}

2.3 退款状态查询接口

以下是退款状态查询接口的代码，其中入参仅示例了必要的字段，其他详情见官方文档。

// 初始化SDK
IAopClient alipayClient = new DefaultAopClient(GetAlipayConfig());
// 构造请求参数以调用接口
AlipayTradeFastpayRefundQueryRequest request = new AlipayTradeFastpayRefundQueryRequest();
AlipayTradeFastpayRefundQueryModel model = new AlipayTradeFastpayRefundQueryModel();

// 设置查询选项
List<String> queryOptions = new List<String>();
queryOptions.Add("refund_detail_item_list");
model.QueryOptions = queryOptions;

//// 设置商户订单号（与支付宝交易号，配置任一即可）
//model.OutTradeNo = "2014112611001004680073956707";
// 设置支付宝交易号
model.TradeNo = "2024072900000000000000000001";

// 设置退款请求号，来自退款接口中生成的编号
model.OutRequestNo = "ZFB20240729135000591024";

request.SetBizModel(model);
AlipayTradeFastpayRefundQueryResponse response = alipayClient.Execute(request);

if (!response.IsError)
{
    Console.WriteLine("调用成功");
}
else
{
    Console.WriteLine("调用失败");
}

成功返回：

{
	"alipay_trade_fastpay_refund_query_response": {
		"code": "10000",
		"msg": "Success",
		"out_request_no": "ZFB20240729135000591024",
		"out_trade_no": "*****",
		"refund_amount": "0.01",
		"refund_detail_item_list": [
			{
				"amount": "0.01",
				"fund_channel": "COUPON"
			}
		],
		"refund_status": "REFUND_SUCCESS",
		"send_back_fee": "0.01",
		"total_amount": "1.00",
		"trade_no": "*****"
	},
	"sign": "*****"
}