TerraMours:Net7对接支付宝当面付
TerraMours:Net7对接支付宝当面付
使用场景：
TerraMours开源项目之一：基于GPT与stable diffusion webui的开源项目：希望能够加入充值入口，并使用tokens数来扣费。
后台源码地址：https://github.com/TerraMours/TerraMours_Gpt_Api
一：先想清楚自己系统支付的逻辑。
最开始是准备想着根据不同类别的会员来设置。后面感觉很难定价以及市场的波动，同时汇率的起伏。算了，还是类似于充值QB，然后基于金额来消费。这样类似于定好了单位一，也就是1 token多少钱，当前这个并没有解决汇率的问题。这个以7来计算的。
简单的画个图，不一定严谨，方便理解即可
根据这个逻辑，基本上需要用到的技术也定了，由于后台需要推送，那么选择SignalR.
二：查看文档
官方地址：https://opendocs.alipay.com/common/02kkv3
由于官方demo，net的很旧，同时我也希望如果我要对接微信支付，我不需要在引入一个新的库，我希望是一个通用的，但是由于微信支付需要有商家资质，我是开源项目，同时是个人开发。所以只支持支付宝。
选择的开源库是：https://github.com/essensoft/paylink
基本上很简单，同时，项目也有示例代码。
三：对接支付
1.当面付预下单的二维码code接口
请求参数：
out_trade_no这个是自己内部系统的交易号，需要保证唯一。
subject: 主题，与英语邮件类似，英文邮件的主题就是subject，正文是body。可以理解为概要等等
body：具体描述，订单详细说明等
total_amount：这个订单的总金额.支付宝规定：订单总金额，单位为元，精确到小数点后两位，取值范围为 [0.01,100000000]，金额不能为 0。
参数说明官方地址：https://opendocs.alipay.com/open/f540afd8_alipay.trade.precreate?pathHash=d3c84596&ref=api&scene=19
[Required] [Display(Name = "out_trade_no")] public string OutTradeNo { get; set; } [Required] [Display(Name = "subject")] public string Subject { get; set; } [Display(Name = "body")] public string Body { get; set; } [Required] [Display(Name = "total_amount")] public string TotalAmount { get; set; } [Display(Name = "notify_url")] public string NotifyUrl { get; set; }
MinimalApi
/// <summary> /// 当面付-扫码支付 /// </summary> [HttpPost] public async Task<IResult> PreCreate(AlipayTradePreCreateReq viewModel) { if (viewModel.UserId == null) { viewModel.UserId = _httpContextAccessor.HttpContext.User.FindFirstValue(ClaimTypes.UserData); } var res = await _payService.PreCreate(viewModel); return Results.Ok(res); }
PayService
/// <summary> /// 当面付-扫码支付 /// </summary> /// <param name="req"></param> /// <returns></returns> public async Task<ApiResponse<AlipayTradePrecreateResponse>> PreCreate(AlipayTradePreCreateReq req) { //生成系统内唯一交易号 var tradeNo = $"TerraMours-{Guid.NewGuid()}"; // 支付宝规定：订单总金额，单位为元，精确到小数点后两位，取值范围为 [0.01,100000000]，金额不能为 0。 //但是我们系统是decimal 保留六位小数，这里由于充值我们是整数，所以我们只需要传给支付宝的钱处理下，保留两位小数即可 var model = new AlipayTradePrecreateModel { //系统内部的唯一交易号 $"TerraMours-{Guid.NewGuid()}" OutTradeNo = tradeNo, //类似于邮件主题 Subject = req.Name, //金额总数: 将商品价格转换为保留 2 位小数的 decimal 再转换为字符串 TotalAmount = Math.Round(req.Price, 2).ToString(), Body = req.Description }; var request = new AlipayTradePrecreateRequest(); request.SetBizModel(model); request.SetNotifyUrl(req.NotifyUrl); //此时应该先在自己的order表里面创建一个待支付的订单 var order = new Order(req.ProductId, req.Name, req.Description, req.Price, req.UserId, tradeNo); await _dbContext.Orders.AddAsync(order); await _dbContext.SaveChangesAsync(); var response = await _client.ExecuteAsync(request, _optionsAccessor.Value); if (!response.IsError) { return ApiResponse<AlipayTradePrecreateResponse>.Success(response); } return ApiResponse<AlipayTradePrecreateResponse>.Fail("支付宝当面付二维码生成失败"); }
appsettings：支付宝
注意：密钥格式：请选择 PKCS1(非JAVA适用)，切记 切记 切记！！！
记得密钥转化成PKCS1格式的
AppId、AlipayPublicKey、AppPrivateKey 三个参数数据如何获取，自行百度。
// 支付宝 // 更多配置，请查看AlipayOptions类 "Alipay": { // 注意: // 若涉及资金类支出接口(如转账、红包等)接入，必须使用“公钥证书”方式。不涉及到资金类接口，也可以使用“普通公钥”方式进行加签。 // 本示例默认的加签方式为“公钥证书”方式，并调用 CertificateExecuteAsync 方法 执行API。 // 若使用“普通公钥”方式，除了遵守下方注释的规则外，调用 CertificateExecuteAsync 也需改成 ExecuteAsync。 // 支付宝后台密钥/证书官方配置教程：https://opendocs.alipay.com/open/291/105971 // 密钥格式：请选择 PKCS1(非JAVA适用)，切记 切记 切记 // 应用Id // 为支付宝开放平台-APPID "AppId": "", // 支付宝公钥 RSA公钥 // 为支付宝开放平台-支付宝公钥 // “公钥证书”方式时，留空 // “普通公钥”方式时，必填 "AlipayPublicKey": "", // 应用私钥 RSA私钥 // 为“支付宝开放平台开发助手”所生成的应用私钥 "AppPrivateKey": "", // 服务网关地址 // 默认为正式环境地址 "ServerUrl": "https://openapi.alipay.com/gateway.do", // 签名类型 // 支持：RSA2(SHA256WithRSA)、RSA1(SHA1WithRSA) // 默认为RSA2 "SignType": "RSA2", // 应用公钥证书 // 可为证书文件路径 / 证书文件的base64字符串 // “公钥证书”方式时，必填 // “普通公钥”方式时，留空 "AppPublicCert": "", // 支付宝公钥证书 // 可为证书文件路径 / 证书文件的base64字符串 // “公钥证书”方式时，必填 // “普通公钥”方式时，留空 "AlipayPublicCert": "", // 支付宝根证书 // 可为证书文件路径 / 证书文件的base64字符串 // “公钥证书”方式时，必填 // “普通公钥”方式时，留空 "AlipayRootCert": "" }
2.查询订单支付状态
一：单个只做查询，没有逻辑，这个可以自己后台或者提供给用户自己查询订单的信息的接口
MinimalApi
/// <summary> /// 支付宝交易查询 /// </summary> [HttpPost] public async Task<IResult> Query(AlipayTradeQueryReq viewMode) { var res = await _payService.Query(viewMode); return Results.Ok(res); }
PayService
OutTradeNo：是自己系统生成的唯一交易号。
TradeNo：是支付宝那边的交易号，如果查询这个交易详细信息，传这两个的任意一个都可以查询。但是一开始没支付成功是没有这个的，需要后续自己查询之后再自己保存这个交易号到自己数据库。
/// <summary> /// 交易查询 /// </summary> /// <param name="req"></param> /// <returns></returns> public async Task<ApiResponse<AlipayTradeQueryResponse>> Query(AlipayTradeQueryReq req) { var model = new AlipayTradeQueryModel { OutTradeNo = req.OutTradeNo, //可以不传 TradeNo = req.TradeNo }; var request = new AlipayTradeQueryRequest(); request.SetBizModel(model); var res = await _client.ExecuteAsync(request, _optionsAccessor.Value); return ApiResponse<AlipayTradeQueryResponse>.Success(res); }
二：后台查询三分钟，通过SignalR向前端推送订单状态。
PaymentHub
using Essensoft.Paylink.Alipay; using Essensoft.Paylink.Alipay.Domain; using Essensoft.Paylink.Alipay.Request; using Essensoft.Paylink.Alipay.Response; using Microsoft.AspNetCore.Cors; using Microsoft.AspNetCore.SignalR; using Microsoft.EntityFrameworkCore; using Microsoft.Extensions.Options; using TerraMours.Framework.Infrastructure.EFCore; using TerraMours_Gpt.Domains.PayDomain.Contracts.Req; using ILogger = Serilog.ILogger; using TerraMours_Gpt.Framework.Infrastructure.Contracts.Commons.Enums; namespace TerraMours_Gpt.Domains.PayDomain.Hubs { /// <summary> /// 支付相关的长连接 /// </summary> [EnableCors("MyPolicy")] public class PaymentHub : Hub { private readonly IAlipayClient _client; private readonly IOptions<AlipayOptions> _optionsAccessor; private readonly FrameworkDbContext _dbContext; private readonly Serilog.ILogger _logger; public PaymentHub(IAlipayClient client, IOptions<AlipayOptions> optionsAccessor, FrameworkDbContext dbContext, ILogger logger) { _client = client; _optionsAccessor = optionsAccessor; _dbContext = dbContext; _logger = logger; } /// <summary> /// 即时查询状态 /// </summary> /// <param name="req"></param> /// <returns></returns> public async Task QueryPaymentStatus(AlipayTradeQueryReq req) { _logger.Warning($"即时查询状态，订单号:{req.OutTradeNo}"); //获取当前连接id var connectionId = this.Context.ConnectionId; //先查询系统里面是否有此账单 // todo 支付成功 则修改用户vip信息 var order = await _dbContext.Orders.FirstOrDefaultAsync(x => x.OrderId == req.OutTradeNo) ?? throw new Exception("此订单不存在"); var model = new AlipayTradeQueryModel { OutTradeNo = req.OutTradeNo, //可以不传 TradeNo = req.TradeNo }; var request = new AlipayTradeQueryRequest(); request.SetBizModel(model); //循环查询3分钟这个账单，超时或者状态位已支付则停止 using var httpClient = new HttpClient(); var startTime = DateTime.Now; //先查一次 以免使用未赋值的变量 AlipayTradeQueryResponse queryPayRes = await _client.ExecuteAsync(request, _optionsAccessor.Value); _logger.Warning($"第一次查询返回:{req.OutTradeNo},交易状态：{queryPayRes.TradeStatus}"); while ((DateTime.Now - startTime).TotalMinutes <= 3) { queryPayRes = await _client.ExecuteAsync(request, _optionsAccessor.Value); if (queryPayRes.TradeStatus != "WAIT_BUYER_PAY") { _logger.Warning($"订单号状态改变:{req.OutTradeNo},交易状态：{queryPayRes.TradeStatus}"); //交易状态：WAIT_BUYER_PAY（交易创建，等待买家付款）、TRADE_CLOSED（未付款交易超时关闭，或支付完成后全额退款）、TRADE_SUCCESS（交易支付成功）、TRADE_FINISHED（交易结束，不可退款） break; } // 间隔3秒进行下一次查询 await Task.Delay(3000); } // 如果超过3分钟仍未支付，发送订单状态信息 order.PayOrder(queryPayRes.TradeNo, queryPayRes.TradeStatus); _dbContext.Orders.Update(order); await _dbContext.SaveChangesAsync(); //如果支付成功，则把user的余额加上新充值的钱 var user = await _dbContext.SysUsers.FirstOrDefaultAsync(x => x.UserEmail == order.UserId) ?? throw new Exception("此用户不存在"); user.Balance = user.Balance + order.Price; _dbContext.SysUsers.Update(user); await _dbContext.SaveChangesAsync(); var res = false; //交易状态：WAIT_BUYER_PAY（交易创建，等待买家付款）、TRADE_CLOSED（未付款交易超时关闭，或支付完成后全额退款）、TRADE_SUCCESS（交易支付成功）、TRADE_FINISHED（交易结束，不可退款） if (queryPayRes.TradeStatus == AlipayTradeStatusEnum.TRADE_SUCCESS.ToString()) { res = true; } //queryPayRes,前端只需要传是否成功即可 await Clients.Client(connectionId).SendAsync("QueryPaymentStatus", res); } } }
跳出循环之后，建议再查询一次。这样保证Delay的时间如果在三分钟边界上，可能会有支付成功，但是返回的是没有支付这种情况
总结
整体上来说，采用这个开源库，由于demo示例代码都有，基本上不难，需要注意的是，非Java需要先把密钥格式转化为PKCS1的密钥。当然这个系统对金钱以及安全要求都不高，只是单纯记录TerraMours相关项目的开发过程而已。详细代码可以看GitHub源码。前端源码也是开源，都在组织项目里面。
后台源码地址：https://github.com/TerraMours/TerraMours_Gpt_Api
前端源码地址：https://github.com/TerraMours/TerraMours_Gpt_Web
后台管理前端源码地址：https://github.com/TerraMours/TerraMours_Admin_Web
