支付宝集成:为你的 SaaS 接入原生支付宝收款
在 ShipAny 中用原生支付宝向国内用户收款——RSA2 签名的网页支付、验签的异步通知和自动发放积分。
最后更新: 2026年10月8日
如果你的用户主要在中国大陆,原生支付宝商户号能给他们最熟悉、最放心的付款体验。ShipAny 在 Stripe 和 Creem 之外内置了原生支付宝渠道,无需第三方聚合支付就能用人民币收款。
ShipAny 帮你做了什么
- 网页支付:调用
alipay.trade.page.pay,用你的 RSA2 私钥签名。 - 异步通知:
/api/payment/notify/alipay用支付宝公钥验签,并按支付宝要求返回纯文本success,避免通知被无限重试。 - 订单查询:用户先于通知返回时,用
alipay.trade.query兜底确认支付结果。 - 订单与积分:收到支付成功通知后,在同一个事务里把订单标记为已支付并发放积分。
- 测试金额:以「分」为单位,上线前可以用 0.01 元跑通完整流程。
原生支付宝用于一次性付款(积分包、买断套餐)。周期订阅请使用 Stripe 或 Creem。
配置步骤
- 在支付宝开放平台创建应用,并开通电脑网站支付产品。
- 生成 RSA2 密钥对,把应用公钥上传到支付宝,再复制支付宝返回的支付宝公钥。
- 在 ShipAny 中打开 管理后台 → 设置 → 支付 → Alipay:打开 Enable Alipay,填入 App ID、RSA2 应用私钥、支付宝公钥,以及通知地址
https://<你的域名>/api/payment/notify/alipay。 - 可以把测试金额设为
1(0.01 元)下单测试,上线前记得清空。
注意事项
- 验签要用支付宝公钥,不是应用公钥——这是异步通知失败最常见的原因。
- 通知地址必须是公网 HTTPS,并且指向实际运行应用的域名。
- 同时面向海外用户?Stripe 也能在一次性付款中提供支付宝,不需要单独签约支付宝。
