大家好,我是码农刚子。今天分享一下 .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码农刚子」,提升编程技能

精选推荐(点击标题可跳转):