支付宝
通过支付宝电脑网站收银台收取人民币付款。
- 结账 支付宝电脑网站收银台(
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 已配置。
两个公钥别混淆
验证
- 用普通用户登录,打开
/pricing,购买人民币一次性套餐。预期:跳转到支付宝收银台。 - 用沙箱买家账号付款。预期:经
/api/billing/callback/alipay回到站点,服务端先用alipay.trade.query查单,再把订单标记为已付款。 - 打开
/admin/billing-webhooks。预期:出现一条来自支付宝、签名有效的TRADE_SUCCESS事件。 - 在
/admin/orders为这笔订单退款。预期:退款立即成功。
切换到正式环境
- 把 API base URL 改为
https://openapi.alipay.com/gateway.do。 - 保存正式应用的 APPID、应用私钥和正式环境的支付宝公钥。沙箱密钥无法验证正式环境的通知。
- 实付一笔并退款。
常见问题
支付宝下单被拒绝,原因是 provider_unsupported
支付宝只收人民币一次性付款。在 /admin/plans 把套餐的币种设为 CNY、计费周期设为一次性或终身,或改用其它服务商收款。
人民币套餐走了微信支付而不是支付宝
微信支付启用且配置齐全时优先收人民币套餐。如果要由支付宝收款,在 /admin/config/payment 取消启用微信支付。
通知记录的类型带 .mismatch
签名通过,但 app_id、seller_id 或 total_amount 与订单不一致。核对保存的应用 APPID 和卖家用户号,并确认下单后没有修改套餐价格。