个人开发者接入支付宝当面付！再也不用担心收款问题了～

爱意满满的作品展示区。

最近自己做了个 AI 绘图应用，并且成功接入支付宝当面付，感觉很赞，所以写一篇分享的文章，希望对一些独立开发者有些帮助！

一、为什么个人开发者适合用“当面付”

如果你是个人开发者，想给自己的网站、小工具、AI 绘图应用、会员系统、积分充值系统接入支付宝收款，常见选择有三类：

电脑网站支付
手机网站支付
当面付扫码支付

对个人开发者来说，最容易落地的一般是支付宝当面付。它的典型支付流程是：

用户在网页选择充值套餐 → 后端创建本地订单 → 后端调用支付宝预创建订单接口 → 支付宝返回二维码内容 → 前端展示二维码 → 用户用支付宝扫码付款 → 后端通过异步通知或主动查询确认支付成功 → 给用户发放积分、会员、服务额度。

这套流程很适合个人网站，因为前端不需要跳转支付宝收银台，只需要展示一个二维码即可。它的体验也很直观：用户扫码付款，页面轮询订单状态，付款成功后自动更新。

二、接入前你需要准备什么

1. 支付宝账号

你需要一个已经实名认证的支付宝账号，并登录支付宝开放平台（ https://openhome.alipay.com/）。

建议使用你准备收款的支付宝账号申请，不要用临时账号。后面收款、结算、风控、主体信息都和这个账号有关。

2. 开放平台应用

进入支付宝开放平台后，创建一个网页/自用应用。应用创建完成后，你会拿到一个核心参数：

APP_ID

这个就是你后端调用支付宝接口时要用的应用 ID 。

3. 开通“当面付”能力

在应用或商家产品能力里申请开通当面付。

当面付本质上是线下扫码收单能力，所以申请时可能会让你填写：

店铺名称经营地址经营类目经营场景门店/经营场所照片营业执照或其他资质材料

其中营业执照不是必须的，其他店铺名称什么的随便填，门店/经营场所照片直接用网上的照片，或者 AI 生成，我用的 gpt-image-2 生成的门店照片是可以的，直接生成沙县小吃或者淮南牛肉汤这种门店即可！

4. 开通消息服务

必须开通相关的消息服务你才有调用支付宝接口的能力。在开发设置里订阅下面必须的功能，资金单据状态变更通知，资金退回成功通知。

4. 服务器与域名

生产环境建议准备：

HTTPS 域名(这个需要一个你可以访问的线上地址，开通当面付、网页支付时需要)
后端服务公网可访问
notify_url 可以被支付宝服务器访问（非必填，一般在代码里写这个地址）。

异步通知地址必须是外网可访问的接口。你本地的 localhost 收不到支付宝正式环境回调。

开发阶段可以用内网穿透工具做临时调试，比如 ngrok 、cpolar 、frp 等，但上线一定要换成正式 HTTPS 域名。

三、支付宝 sdk

支付宝 sdk 提供了很多封装好的接口，让开发者方便使用支付宝开放平台的能力。因为我后端用的是 nodejs ，直接使用的 Alipay OpenAPI SDK （ https://www.npmjs.com/package/alipay-sdk ）。

开发设置

开发者只需要设置接口加签方式（密钥/证书）即可，设置时会有指引（很贴心！），拿到参数放到下面代码中即可使用支付宝 sdk!

import { AlipaySdk } from 'alipay-sdk';

// 实例化客户端
const alipaySdk = new AlipaySdk({
  // 设置应用 ID
  appId: 'your-APPID',
  // 设置应用私钥
  privateKey: fs.readFileSync('/path/to/private-key.pem', 'ascii'),
  // 设置支付宝公钥
  alipayPublicKey: fs.readFileSync('/path/to/alipay-public-key.pem', 'ascii'),
  // 密钥类型，请与生成的密钥格式保持一致，参考平台配置一节
  // keyType: 'PKCS1',
  // 设置网关地址，默认是 https://openapi.alipay.com
  // endpoint: 'https://openapi.alipay.com',
});