充值 & 费用指南
一句话：CodeGateway 按 token 计费，新用户绑定支付方式后可获得起步额度（具体金额以注册/定价页实时展示为准），余额永不过期，钱包中未消耗的余额随时可申请退款（上限为该笔付款金额与钱包可用余额中的较小者），服务倍率为平坦 1.07×（不随消费变化）。
CodeGateway 采用按量计费，没有月订阅。本文一次讲清充值流程、价格机制、退款政策、发票获取等所有计费相关的问题。
一、充值流程
1. 进入充值页面
登录 Dashboard → 账单 页面 → 点击 充值。
2. 选择充值金额
预设档位：$10 / $20 / $50 / $100。也可以输入自定义金额（最低 $5，最高 $10000）。
3. Stripe 跳转付款
点 去支付 后跳转到 Stripe 官方收银台。Stripe 是我们的全球支付服务商。CodeGateway 价格以美元(USD)计价,CodeGateway 接受信用卡（Visa / Mastercard / AmEx）、Stripe Link、支付宝与银行转账；Stripe 在收银台按你的账单地址决定可用的卡组织。
收银台呈现的具体支付方式以 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.07× 倍率计费：不随 90 天消耗或充值金额变化，也不存在降档。
详细规则见 统一倍率说明。
三、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 次（管理员可在 CMS 调整）
- 申请前 5 分钟内无 API 调用（防止 in-flight 计费冲突；具体秒数由
refundIdleSeconds配置）
退款流程
Dashboard → 账单 → 退款 按钮 → 输入退款理由 → 提交。
Stripe 原路返回到原支付卡，1-3 个工作日到账（具体时长以发卡行为准）。
退款限制与例外
- 赠送余额（如绑定支付方式后的注册礼、邀请奖励）在钱包中不单独区分；未使用的赠送额度可能被计入可退金额
- 已通过开发票冲销的金额不可退款（避免税务复杂度）
- Stripe 退款失败时（如发卡行拒绝），余额会自动回滚，可重新申请
五、发票
CodeGateway 通过 Stripe 直接开具官方发票，方便企业入账。
自动收据
每次充值成功，Stripe 会自动发一封 付款收据邮件到你注册账户邮箱。这封收据可以作为入账凭证。
发票内容
发票项目：软件信息技术服务费。
抬头按你提交的公司名出（个人也可开个人抬头）。
六、余额提醒
低余额会影响业务连续性。我们提供两层提醒：
Dashboard 内提醒
余额低于 $2 时，Dashboard 顶部会出现红色横条提醒。
邮件提醒
余额低于 $5 时，每天发一封邮件到你注册邮箱（避免轰炸，每天最多 1 封）。
自动充值（Auto Top-Up）已上线：在 Dashboard 打开「账单 → 支付方式 / 自动充值」进入设置；开启并绑定支付方式后，余额低于阈值时会自动扣款充值，避免业务中断。可随时关闭或恢复。
七、常见问题
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 错误（详见 常见报错排查指南）。账户不会被禁用，充值后立即恢复。