用途:将 Creem 支付基础设施集成到应用中,处理结账、订阅、免费产品、许可证和 Webhook。Creem 是记录商户(MoR)支付平台,作为法定卖家负责税务合规、支付处理、拒付与退款。
主要能力:支持一次性付款、周期计费、免费产品、许可证密钥、折扣与交易。参考文档覆盖 Checkouts、Products、Customers、Subscriptions、Licenses、Discounts、Transactions,以及基础 SaaS 订阅、数字交付、桌面应用许可证、按席位团队计费、免费增值升级流程、联盟追踪等工作流。
使用方式:生产 API 为 https://api.creem.io,测试 API 为 https://test-api.creem.io,认证使用 x-api-key 请求头,密钥是商户凭证,绝不能下发到浏览器、移动端或桌面程序,须由后端调用。价格用整数分表示(1000 = $10.00),免费产品用 0。货币为大写三字母 ISO 代码。访问权限由 Webhook 事件授予,而非成功跳转。参考文件按需读取:REFERENCE.md 查端点与字段,WEBHOOKS.md 查事件负载与签名验证,WORKFLOWS.md 查完整集成流程。官方 SDK 覆盖 Node/浏览器、Next.js、Better Auth,Convex 项目建议使用 @creem_io/convex 组件。
限制与安全:所有 Webhook 处理器必须在使用负载前验证签名(对原始请求体做 HMAC-SHA256,先检查长度再 timingSafeEqual),未验证的处理程序会被伪造事件授予付费访问。测试环境可用测试卡 4111 1111 1111 1111(成功)、4507 9900 0000 0028(拒绝)、4507 9900 0000 0010(余额不足)。错误码:400 参数错误、403 密钥无效或权限不足、404 资源不存在、429 限流、500 服务器错误。具体定价与收费细节暂未提供。