Creem
通过 Creem 收款。
- 结账 托管结账页
- 订阅 取消和恢复
- 客户门户 支持
- 退款 只能在 Creem 后台操作
结账接口兼容性
Creem 的结账接口要求传入 product_id。当前适配器发送 product_data,后台也没有 Creem 商品 ID 配置项。需要先对接商品 ID,再用沙箱订单验证收款。 Creem API
准备工作
准备公网 HTTPS 站点、/admin/plans 中已上架的套餐,以及能管理商户设置的账号。
完成后,可以核对测试店铺的 API 地址、签名密钥和通知端点。
在 Creem 完成准备
创建 API Key
在 Developers 创建 API Key,保存密钥。
登记付款通知
在 Webhooks 登记以 /api/billing/webhook/creem 结尾的公网 HTTPS 地址,订阅 checkout.completed,复制签名密钥。
官方说明 · Creem Webhook 指南
填写项目配置
回到 Kernlift 后台,打开 /admin/config/payment。选择 Creem,填写公网成功 URL、取消 URL,将 API base URL 设为 https://test-api.creem.io。
| 来源 | 后台字段 |
|---|---|
| API key | API key |
| Webhook secret | Webhook secret |
| Test API | API base URL |
勾选启用并点击 保存 provider。
验证
先确认适配器已能传入测试商品 ID,再验收以下三步。
- 用沙箱买家账号在
/pricing购买套餐。 - 在
/admin/billing-webhooks确认签名校验通过。 - 在
/admin/orders找到同一订单,确认状态为已付款。
切换到正式环境
在正式账号创建凭据并登记正式域名的 Webhook。将新端点的验签值、同一环境的凭据和 https://api.creem.io 一起保存。
常见问题
webhook 签名校验失败
确认签名密钥来自当前店铺,且端点与 API Key 均在同一环境创建。