Creem

通过 Creem 收款。

  • 结账 托管结账页
  • 订阅 取消和恢复
  • 客户门户 支持
  • 退款 只能在 Creem 后台操作

结账接口兼容性

Creem 的结账接口要求传入 product_id。当前适配器发送 product_data,后台也没有 Creem 商品 ID 配置项。需要先对接商品 ID,再用沙箱订单验证收款。 Creem API

准备工作

准备公网 HTTPS 站点、/admin/plans 中已上架的套餐,以及能管理商户设置的账号。

完成后,可以核对测试店铺的 API 地址、签名密钥和通知端点。

在 Creem 完成准备

选择测试店铺

打开 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 keyAPI key
Webhook secretWebhook secret
Test APIAPI base URL

勾选启用并点击 保存 provider。

Kernlift 后台的 Creem 配置字段

验证

先确认适配器已能传入测试商品 ID,再验收以下三步。

  1. 用沙箱买家账号在 /pricing 购买套餐。
  2. 在 /admin/billing-webhooks 确认签名校验通过。
  3. 在 /admin/orders 找到同一订单,确认状态为已付款。

切换到正式环境

在正式账号创建凭据并登记正式域名的 Webhook。将新端点的验签值、同一环境的凭据和 https://api.creem.io 一起保存。

常见问题

webhook 签名校验失败

确认签名密钥来自当前店铺,且端点与 API Key 均在同一环境创建。

下一步

接入支付服务商