支付宝退款和结果查询接口简单实现(.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 格式,适用于其他全部语言。

有两种方式进行转换:如果账号很少,可以通过官方密钥工具进行转换;如果账户比较多,可以在代码中实现转换。如下详解:

第一种:通过代码转换

通过添加引用:XC.RSAUtil,可直接引用转换方法。

using XC.RSAUtil;

string privateKey = "MIIEvgIBADANBgk ... ...";
privateKey = RsaKeyConvert.PrivateKeyPkcs8ToPkcs1(privateKey); // PKCS8 --> PKCS1

参考(包含多种类型转换):https://www.cnblogs.com/stulzq/p/8260873.html

第二种:官方密钥工具

密钥工具下载地址: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": "*****"
}
posted @ 2024-07-29 18:47  橙子家  阅读(694)  评论(0编辑  收藏  举报