出海开发
海外收款、订阅与权益
核对真实商品币种、付款回调和 AI 成本,避免只修改展示价格。
当前 provider
默认支付 provider 为 Creem,入口在 src/integrations/payment/providers/index.ts,实现位于 creem.ts;仓库也存在 Stripe provider 与 webhook 入口。存在适配文件不等于当前生产已启用或已完成收款联调。
选服务商时确认商户所在地区、目标用户付款方式、结算币种、订阅和退款能力。税务与 Merchant of Record 的责任取决于真实合同,不能根据 provider 名称推定。
商品配置
套餐配置在 src/config/index.ts,新订阅价格使用对应 CNY Price ID。海外币种方案需要同时核对供应商商品、价格契约、结账、展示、权益与历史订单识别。
不能只把货币符号换成美元。金额数值的单位、周期、试用期和一次性付款语义以本项目 provider 与价格类型为准。
完整链路
创建结账链接
→ 供应商完成付款
→ 验证 webhook
→ 更新购买 / 订阅
→ 识别有效权益
→ 发放积分 / 提供月度 Token 额度客户端成功回跳不是付款凭据,权益应由服务端确认。Webhook 可能重复、迟到或乱序,维护幂等性和既有商品别名识别。
AI 产品成本
区分订阅 Token 额度、平台积分、图片成本与 BYOK。自有密钥请求不扣平台额度,但仍有应用和存储成本。定价前用真实目标语言样本测量输入输出 Token、图片频率和高成本请求比例。
验证矩阵
- 新订阅、续费、取消、到期、一次性购买和退款。
- 重复 webhook 与返回页先于 webhook。
- 旧商品继续识别权益,新结账只用新商品。
- 支付暂未配置时不生成错误的结账链接。
- 月度积分只发一次,过期用户不继续获得订阅额度。
用户结算操作与套餐查询:src/features/billing/actions;支付回调与供应商集成:src/integrations/payment/actions、src/integrations/payment/entitlements.ts、src/integrations/payment/prices.ts。计费规则见AI 额度。