大家好,我是码农刚子。今天分享一下 .NET 接入个人支付宝手机网站支付过程。
个人账号其实一直能入驻支付宝开放平台,也能接支付产品。卡住的是后面。不提供营业执照,线上收款就限额度,单笔 50 元、单日 1000 元。手机网站支付的部分说明还要求账号主体和营业执照一致。技术上门开着,钱进不来。
这两年才变。2025 年的 AI 打赏、2026 年的 AI 收,到现在的 Vibe Pay,支付宝第一次把「个人也能收款」写成了产品卖点。aipay.alipay.com 上,Vibe Pay 三条卖点里最后一条就是「个人也能收款,支持符合条件的个人创作者开展应用商业化」。
这次为了一个 9 块 9 的小站,我拿个人身份证实名过的支付宝账户,在它下面把「基础收款能力」里的手机网站支付签了下来。从提交到审核通过,一个工作日。没有营业执照,没有对公账户。
所以这篇不只是代码。门槛这件事,可能比很多人以为的低。
先把话说清楚。官方写的是「符合条件的个人创作者」,不是所有人都能开。独立开发者模式目前定向开放,要申请获批;能不能过,跟应用形态、收费场景、审核口径都有关系。我写的是我这一条路走通了,不是替平台宣布政策。
剩下的部分是技术。前后花了两天,接口本身不算复杂,麻烦全在文档之外。记下来,省得下次再踩。
需求与选型
需求很朴素。车主在小站上填车型、改色范围、膜料档次、所在城市,系统按人工整理的分片面积表算出一个合理报价区间,生成一份 PDF 确认单,收 9.9 元。我手里只有一台 Windows 服务器、一个 .NET 10 的站点,没有 App,也没有认证服务号。这个条件基本决定了后面所有的选型。
先站到 AI 支付的地图上
aipay 不是另一个支付宝。底下还是同一套收单、风控和资金清算,它只是给 AI 业务单独开的一层入口。进去先找自己。
| 产品 | 卖给谁 | 卖什么 |
|---|---|---|
| Agent Pay | 智能体平台、商品商家 | Agent 在用户授权下替人下单付款 |
| Vibe Pay | AI 应用创作者、独立开发者 | 网页或 App 里的功能、内容、额度、时长 |
| Skill Pay | Skill 开发者 | Skill 的买断或订阅 |
| Machine Pay | API 服务商 | 按调用量计费 |
| Token Pay | 大模型、云厂商 | Token 与席位订阅 |
我这个小站是给人用的网页,卖一份 PDF 确认单,落在 Vibe Pay。
Vibe Pay 内部还有两条路:智能收款套件,商品、订单、权益连同后台一起给你,扫码配个价就能开卖;基础收款能力只给三样东西,支付、订单查询、退款,剩下的付款流程、订单表、权益次数,你自己写。我选了后者。原因很土,订单表、权益次数、下载链接我已经写完了,套件那套后台对我没用,反而多一层要维护的东西。官方对这条路的描述是「适合已有商品、订单、权益管理及后台的应用」。自己写系统的人,正好对口。
先选对产品,能省掉一半麻烦
落到基础收款能力这一层,得再选一个具体支付产品。支付宝的收款产品有七八个,挑起来容易晕。真正需要比的是这四个。
| 产品 | 适用场景 | 我的判断 |
|---|---|---|
| APP 支付 | 原生 App 内 | 没有 App,排除 |
| JSAPI 支付 | 微信或支付宝内网页 | 要认证服务号加网页授权,链路太长 |
| 当面付 | 收银台扫码 | 手机端要退出再扫码,体验绕 |
| 手机网站支付 | 手机浏览器里的 H5 | 选它,一个表单就能拉起客户端 |
手机网站支付只需要浏览器和一个表单,正好对上当时的条件。整条链路就三步:服务端算价生成待支付订单 → wap.pay 返回 HTML 表单 → 浏览器提交支付后回调发权益。
整条链路只有三步,但每一步都能卡住你
坑 1:ISV 权限不足,不是密钥问题
第一次点支付,报的是 insufficient-isv-permissions,文案写着 ISV 权限不足,请检查签约是否已经生效。我的第一反应是密钥配错了,换了两次密钥,一点用没有。
后来才搞明白这里是两件独立的事:商家侧要做签约,在商家平台开通「手机网站支付」这个能力;开放平台侧要做绑定,把应用和这个产品关联起来。任何一边没做,都会报同一个错。而报错文案一个字都没提「缺绑定」。
先查签约状态,再查产品绑定,别去动密钥。
坑 2:签名报「不正确的长度」
权限通了,第二个错更有意思:RSA签名遭遇异常,请检查私钥格式是否正确。不正确的长度。
这个错九成不是长度问题,是格式问题。支付宝的密钥工具导出的私钥有两种编码,PKCS#8 和 PKCS#1。这套 .NET SDK 只认 PKCS#1。
判断方法很土:PKCS#1 差不多 1600 个字符,PKCS#8 更长,因为前面多了一段算法标识。转格式一条命令就够:
openssl rsa -in pkcs8.pem -out pkcs1.pem
转完还要删掉首尾的 BEGIN 和 END 两行,去掉所有换行,压成一个连续字符串。少做这一步,报的还是同一个错。
报错说长度,其实是格式。PKCS#1 要裸串,不要 PEM 头,不要换行。
坑 3:电脑网站支付,在手机上不能用
我一开始用的是 alipay.trade.page.pay。本地测下来一切正常,手机一打开就提示「请用电脑访问」。
手机浏览器要用手机网站支付,接口是 alipay.trade.wap.pay,业务参数里 product_code 必须写 QUICK_MSECURITY_PAY。
换完接口,又卡在一个更隐蔽的地方。这个 SDK 的页面跳转方法叫 pageExecute,首字母小写。文档示例里写的是 PageExecute,复制粘贴的时候很容易忽略这个差别,然后编译直接不通过。
更关键的是返回值。pageExecute 返回的是一段 HTML 表单,不是一条支付链接。我最开始的写法是 location.href 赋这个返回值,页面直接变成一屏源码,还带一堆 input。正确做法是把这段 HTML 塞进页面,再让它自己 submit。
拿到一串 HTML,别当链接用。
落到代码,服务端只做两件事:建单,拿表单。
var request = new AlipayTradeWapPayRequest();
request.SetNotifyUrl(notifyUrl);
request.SetReturnUrl(returnUrl);
request.SetBizModel(new AlipayTradeWapPayModel
{
OutTradeNo = orderNo,
TotalAmount = amount.ToString("0.00"),
Subject = subject,
ProductCode = "QUICK_MSECURITY_PAY",
});
// 小写 pageExecute,返回 HTML 表单
var payHtml = _client.pageExecute(request, null, "POST").Body;
前端拿到这个字符串,塞进容器再提交。
const res = await fetch('/api/orders', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(form),
});
const { payHtml } = await res.json();
const holder = document.createElement('div');
holder.innerHTML = payHtml;
document.body.appendChild(holder);
holder.querySelector('form').submit();
坑 4:回调重复,权益发了两次
支付宝的异步通知会重推。同一笔订单收到三次五次,很正常。我最初的写法是先查订单状态,如果还是待支付,就改成已支付,然后发下载权益。这个写法在并发下一定会炸。两个通知同时查到「待支付」,就都去发权益,用户拿到两条下载链接。
改成带条件的 UPDATE,一条 SQL 解决。条件是订单号匹配、状态为待支付、交易号为空。执行完看影响行数,是 1 才继续发权益,是 0 就直接当重复通知返回。用影响行数判重,不要先查再改。 这是支付回调最容易踩、也最容易被忽略的一处。
完整的一段,从验签到最后发权益:
// 1. 验签,公钥传字符串,最后一个参数 false
if (!AlipaySignature.RSACheckV1(form, alipayPublicKey, "UTF-8", "RSA2", false))
{
return Results.Text("fail", "text/plain");
}
// 2. 金额只信自己库里的
if (form["total_amount"] != order.Amount.ToString("0.00"))
{
return Results.Text("fail", "text/plain");
}
// 3. 条件 UPDATE,用影响行数判重
var affected = await db.Orders
.Where(x => x.OrderNo == orderNo
&& x.Status == OrderStatus.Created
&& x.TradeNo == null)
.ExecuteUpdateAsync(s => s
.SetProperty(x => x.Status, OrderStatus.Paid)
.SetProperty(x => x.TradeNo, tradeNo)
.SetProperty(x => x.PaidAtUtc, now), ct);
// 0 就是重复通知,直接放过
if (affected == 0) return Results.Text("success", "text/plain");
await IssueEntitlementAsync(orderNo, ct);
return Results.Text("success", "text/plain");
最后两行别写错。成功返回纯文本 success,其它一律 fail。返回 JSON、返回空 200,支付宝都当成没收到,第二天继续重推。
坑 5:微信里点支付,什么都发生不了
用户在微信里打开链接,点支付,微信会把跳转拦掉。这事没有技术解。内置浏览器里根本跳不过去,试多少种写法都一样。
我现在的做法是检测 User-Agent,含 MicroMessenger 就把支付按钮换掉,提示用户点右上角,在浏览器里打开。不做自动跳转。跳不动,还容易白屏,用户会以为站点坏了。
在微信里,最好的处理是老实告诉用户换浏览器。 省下的是自己的时间。
坑 6:部署,三个坑一次踩完
第一个是运行时。 服务器没装 .NET 运行时,站点直接 500.31,页面只有一段英文。改成 self-contained 发布到 win-x64,把运行时打进包里,问题消失。
第二个是配置存哪。 AppId、应用私钥、支付宝公钥、回调地址,我都放在 IIS 的环境变量里,前缀 Alipay__,双下划线对应配置层级。这样重新发布不会把密钥冲掉。顺带说一句,配置缺失的时候让它启动失败,比启动成功但支付报错要好查一百倍。
var alipay = builder.Configuration
.GetSection("Alipay")
.Get() ?? throw new InvalidOperationException(
"未找到支付宝配置(Alipay__AppId 等环境变量)");
注意这里没有一行手动读环境变量的代码。Alipay__AppId 会自动映射成 Alipay:AppId,双下划线就是层级分隔符。
第三个坑最省事也最致命,发布包里不要带 web.config。 线上的 web.config 里配着自包含启动路径、环境变量、还有 IIS 层的 HTTP 到 HTTPS 跳转规则。发布时覆盖掉,站点当场打不开,报错还是 500.30。还有一个小细节,HTTPS 跳转只在一层做。IIS 已经做了 301,应用里就不要再跳一次,否则无限重定向,浏览器会直接放弃。
发布包里的 web.config,是覆盖线上配置的凶器。 打包时显式排除,比事后排查便宜太多。
坑 7:SQLite 只读
站点终于起来了,下单报 SQLite Error 8: attempt to write a readonly database。库文件就在站点目录下。IIS 应用池对站点目录默认只有读和执行权限。
给数据目录加 Modify 能解决。我最后选了另一种,把库挪到站点目录外面,单独一个目录。原因很现实。整包覆盖发布的时候,站点目录里的东西随时可能没了。
能读能执行,不等于能写。数据库别放在会被覆盖的目录里。
一张表带走排查
这七个坑的报错文案,没有一条指向真正的根因。存下来,下次直接对号。
| 报错 | 真正原因 | 动作 |
|---|---|---|
insufficient-isv-permissions |
应用未绑定产品 | 商家签约加开放平台绑定 |
不正确的长度 |
私钥是 PKCS#8 | 转 PKCS#1 并去掉头尾换行 |
请用电脑访问 |
用了 page.pay |
换 wap.pay 加 QUICK_MSECURITY_PAY |
| 前端拿不到表单 | 用了 PageExecute |
换小写的 pageExecute |
| 权益重复发放 | 先查再改,并发下穿透 | 条件 UPDATE 加影响行数 |
| 500.31 | 服务器缺运行时 | self-contained 发布 win-x64 |
readonly database |
目录没有写权限 | 加 Modify 或把库外置 |
最后
回头看,支付最反直觉的地方在于,它看起来是调一个接口,实际上你在同时对齐三样东西:签约状态、密钥格式、部署环境。这三样任何一样不对,报错都长得像签名失败。于是你会一直盯着代码,而问题根本不在代码里。所以我现在的习惯是,动手写代码之前先把这三件事写在纸上,逐个确认。真正写接口反而是最快的一步。
回头看,门槛真正挪动的地方不是技术。以前这道门是半掩的。个人开发者想收钱,第一道关是「你有没有营业执照」,没有就只能收 50 块一笔的小额单。现在官方把「个人也能收款」写进了产品页,我这样的个人账户递交申请,一个工作日批下来。它也没有变成零门槛。「符合条件」和「申请获批」都还在,只是从资质审核,变成了资格确认。对想把小工具做成生意的人来说,这个变化比任何接口文档都重要。
站点跑了一周,9 块 9 的单子陆续进来。
让我睡不着的从来不是支付接口,是那个会被覆盖的 web.config。接口文档能教你调通,线上环境才教你留后路。
推荐关注微信公众号「DotNet码农刚子」,提升编程技能
精选推荐(点击标题可跳转):
- 使用 C# 实现23种常见的设计模式
- C# WinForms 实现打印监听组件
- 一个基于 .NET 开源、简易、轻量级的进销存管理系统
- ASP.NET Core Blazor简介和快速入门一(基础篇)
- ZR.Admin.NET:为.NET开发者打造的效率利器,一站式企业级后台开源框架
- ML.NET 快速入门与实践教程:机器学习框架
- .NET面试经典三问:什么是.NET、.NET Framework、.NET Core?及相关引申问题
- 都是微软亲儿子,WPF凭啥干不掉WinForm?这3个场景说明白了
- .NET 8 Web开发入门(七):安全门禁——JWT 身份验证与授权实战
- Blazor Server 中使用 MiniExcel 实现 Excel 导出与导入 — 实战教程
- 用 Inno Setup 把 .NET 程序打包成安装包:从零到发布的完整指南
暂无评论,来抢沙发吧~