支付宝

通过支付宝电脑网站收银台收取人民币付款。

  • 结账 支付宝电脑网站收银台(alipay.trade.page.pay),只收人民币一次性付款
  • 订阅 不支持
  • 客户门户 不支持
  • 退款 支持
  • 优惠码 不支持

人民币计价的套餐在微信支付启用且配置齐全时走微信支付,否则走支付宝。其它币种或订阅套餐会在调用支付宝之前被拒绝。

准备工作

准备公网 HTTPS 站点、/admin/plans 中以 CNY 计价的一次性套餐(见管理定价套餐),以及支付宝开放平台账号。先用沙箱应用测试,后台网关字段默认就指向沙箱。

完成后,一笔订单经验签通过的异步通知结算,并能在后台退款。

在支付宝完成准备

打开沙箱应用

打开支付宝开放平台,使用沙箱应用。上线时创建网页 / 移动应用,并为它签约电脑网站支付。

生成应用密钥

用支付宝密钥工具生成 RSA2(2048 位)密钥对,保存应用私钥;PKCS#1 和 PKCS#8 格式都可以。

选择公钥模式

在接口加签方式中选择公钥模式(不是证书模式),上传应用公钥,复制页面显示的支付宝公钥。

记下标识

记下 APPID。可选:记下账号的 PID,即 2088 开头的用户号,用于拒绝其它卖家的通知。

异步通知地址不需要在支付宝登记。每个收银台地址都带有 notify_url:成功 URL 的源加上 /api/billing/webhook/alipay。

官方说明 · 电脑网站支付 · 异步通知 · 签名与验签

填写项目配置

回到 Kernlift 后台,打开 /admin/config/payment。选择 Alipay(支付宝),填写公网成功 URL 和取消 URL。测试期间 API base URL 保持沙箱网关 https://openapi-sandbox.dl.alipaydev.com/gateway.do。

来源后台字段
应用的 APPID应用 APPID
账号 PID(2088…),可选卖家支付宝用户号(2088 开头,可选)
你生成的密钥对中的私钥应用私钥
上传应用公钥后显示的支付宝公钥支付宝公钥

勾选启用并点击 保存 provider。保存应用 APPID 和两个密钥后卡片显示已配置;保存支付宝公钥后显示 Webhook 已配置。

两个公钥别混淆

这里粘贴的是支付宝公钥,不是应用公钥。用错公钥时通知验签失败,订单停在待付款。密钥可以是 PEM 或纯 base64;密钥字段留空保存会保留原值。
Kernlift 后台的 支付宝 配置字段

验证

  1. 用普通用户登录,打开 /pricing,购买人民币一次性套餐。预期:跳转到支付宝收银台。
  2. 用沙箱买家账号付款。预期:经 /api/billing/callback/alipay 回到站点,服务端先用 alipay.trade.query 查单,再把订单标记为已付款。
  3. 打开 /admin/billing-webhooks。预期:出现一条来自支付宝、签名有效的 TRADE_SUCCESS 事件。
  4. 在 /admin/orders 为这笔订单退款。预期:退款立即成功。

切换到正式环境

  1. 把 API base URL 改为 https://openapi.alipay.com/gateway.do。
  2. 保存正式应用的 APPID、应用私钥和正式环境的支付宝公钥。沙箱密钥无法验证正式环境的通知。
  3. 实付一笔并退款。

常见问题

支付宝下单被拒绝,原因是 provider_unsupported

支付宝只收人民币一次性付款。在 /admin/plans 把套餐的币种设为 CNY、计费周期设为一次性或终身,或改用其它服务商收款。

人民币套餐走了微信支付而不是支付宝

微信支付启用且配置齐全时优先收人民币套餐。如果要由支付宝收款,在 /admin/config/payment 取消启用微信支付。

通知记录的类型带 .mismatch

签名通过,但 app_id、seller_id 或 total_amount 与订单不一致。核对保存的应用 APPID 和卖家用户号,并确认下单后没有修改套餐价格。

下一步