充值 & 费用指南
一句话：CodeGateway 按 token 计费，新用户送 $2，余额永不过期，未消耗的自有充值随时可申请退款，倍率随 90 天滚动消耗自动降档（1.5x → 1.2x）。
CodeGateway 采用按量计费，没有月订阅。本文一次讲清充值流程、价格机制、退款政策、发票获取等所有计费相关的问题。
一、充值流程
1. 进入充值页面
登录 Dashboard → 账单 页面 → 点击 充值。
2. 选择充值金额
预设档位：$10 / $20 / $50 / $100。也可以输入自定义金额（最低 $5，最高 $10000）。
3. Stripe 跳转付款
点 去支付 后跳转到 Stripe 官方收银台。Stripe 是我们的全球支付服务商。CodeGateway 价格以美元(USD)计价,Stripe 在收银台展示的支付方式根据你的账单地址由 Stripe 自动决定 —— 通常为 Visa、Mastercard、American Express 等国际信用卡 / 借记卡。
收银台呈现的具体支付方式以 Stripe 当时展示为准。如果你预期的方式没有出现,意味着 Stripe 当前不在该区域为我们的商户类型开放该方式。
注意:CodeGateway 以美元结算。如果你的卡发行币种不是 USD,发卡行(不是 CodeGateway)会按其汇率把 USD 金额换算到你的本币;Stripe 处理费(约 3.9% + $0.30)由 Stripe 收取。最终扣款金额以 Stripe 收银台显示为准。
4. 自动到账
支付成功后 Stripe 会通过 webhook 通知 CodeGateway，通常 30 秒内余额到账。
如果 5 分钟仍未到账，Dashboard → 账单 → 支付记录 查看状态：
pending—— Stripe 已收款，正在 webhook 同步中succeeded—— 余额已到账failed—— 支付失败，款项会原路退回（1-7 工作日）
二、价格说明
CodeGateway 在 Anthropic 官方价格上加 阶梯倍率：
模型 | 输入价（官方） | 输出价（官方） | 你的实际价格（按倍率乘） |
|---|---|---|---|
Claude Sonnet 4.6 | $3 / 1M | $15 / 1M | 按当前档位倍率 |
Claude Haiku 4.5 | $1 / 1M | $5 / 1M | 按当前档位倍率 |
Claude Opus 4.6/4.7 | $15 / 1M | $75 / 1M | 按当前档位倍率 |
倍率档位：
- 新用户起步 1.5x
- 90 天累计 $10+ 升 1.4x
- 90 天累计 $50+ 升 1.3x
- 90 天累计 $200+ 升 1.25x
- 90 天累计 $500+ 1.2x（铁底线）
详细规则见 阶梯倍率详解。
三、Cache 优惠
Claude Sonnet/Opus 支持 prompt caching：相同的 system prompt + few-shot 例子，第二次起按 cache 价格扣费（仅原价的 10%）。
CodeGateway 完整支持 cache 计费：
- Cache 创建：1.25x 普通价（首次写入）
- Cache 命中：0.1x 普通价（90% 折扣）
合理使用 cache 能在 system prompt 占大头的场景省 80%+ 成本。详见 Anthropic Prompt Caching 文档。
四、退款政策
我们支持未消耗余额随时退款，规则如下：
退款条件
- 仅限自有充值金额（不含赠送余额，如新用户 $1 注册礼）
- 退款金额 ≤ 当前余额扣除赠送部分（自有充值剩多少退多少；同一笔充值只能退一次）
- 每月最多退款 1 次（管理员可在 CMS 调整）
- 申请前 5 分钟内无 API 调用（防止 in-flight 计费冲突；具体秒数由
refundIdleSeconds配置）
退款流程
Dashboard → 账单 → 退款 按钮 → 输入退款理由 → 提交。
Stripe 原路返回到原支付卡，1-3 个工作日到账（具体时长以发卡行为准）。
不可退款的情况
- 赠送余额（如新用户 $1 注册礼、邀请奖励）不可退款，仅自有充值金额可退
- 已通过开发票冲销的金额不可退款（避免税务复杂度）
- Stripe 退款失败时（如发卡行拒绝），余额会自动回滚，可重新申请
五、发票
CodeGateway 通过 Stripe 直接开具官方发票，方便企业入账。
自动收据
每次充值成功，Stripe 会自动发一封 付款收据邮件到你注册账户邮箱。这封收据可以作为入账凭证。
发票内容
发票项目：软件信息技术服务费。
抬头按你提交的公司名出（个人也可开个人抬头）。
六、余额提醒
低余额会影响业务连续性。我们提供两层提醒：
Dashboard 内提醒
余额低于 $2 时，Dashboard 顶部会出现红色横条提醒。
邮件提醒
余额低于 $5 时，每天发一封邮件到你注册邮箱（避免轰炸，每天最多 1 封）。
未来计划上线 自动扣款（Auto Top-Up），余额跌到阈值时自动从绑定卡扣 $X 充值，避免业务中断。可在反馈组件订阅这个功能上线通知。
七、常见问题
Q:CodeGateway 的扣款币种是什么?
A:CodeGateway 以美元(USD)计价并结算。如果你的卡发行币种不是 USD,发卡行会按其汇率把 USD 金额换算到你的本币;Stripe 收银台会在你确认前展示最终的扣款金额。我们不以美元以外的任何货币定价、报价或结算。
Q：余额会过期吗？
A：不会。一次充值的余额永久有效，直到你用完为止。
Q：换 API Key 会影响余额吗？
A：不会。余额属于账户，不属于具体的 Key。一个账户多个 Key 共享同一个余额。
Q：忘记记录用了多少了，怎么对账？
A：Dashboard → 请求日志 页面，每一次调用都有详细记录：模型、token 数、cache 命中、当时倍率、扣费金额。可按时间筛选，或导出 CSV。
Q：余额到 0 之后，下一次调用会怎样？
A：返回 403 insufficient balance 错误（详见 常见报错排查指南）。账户不会被禁用，充值后立即恢复。