自动充值

本页讲计费侧概念与政策；控制台设置流程见 控制台 → 自动充值。

是什么

预付 USD 余额低于阈值时自动从默认付款方式扣款，将额度即时充入账户，避免请求被 insufficient_balance 拒绝。

是生产账号避免业务中断的最常见模式。

与发票的关系

每次自动充值生成一张发票，单行：

Top-up — auto, threshold $50                $200.00

格式与处理与其他付费事件一致——见 发票。

与退款的关系

自动充值仅未消耗部分可退，规则同手动充值——见 退款政策。已通过代理流量消耗的部分不退。

如果怀疑自动充值由滥用触发（凭证泄露、爬虫失控），在 7 天内提交申诉，我们会调查。确认为滥用通常全额退未消耗额度。

日上限是保险

日上限是失控扣款的保险线：

• 设为你可接受的最大单日支出
• 即便余额持续被消耗，单日扣款超过上限即停
• 触顶后请求开始返回 insufficient_balance，直到次日或你手动上调 / 充值

务必设置上限——否则爬虫 bug 可能在你发现前刷掉数千美元。

多币种交互

自动充值金额按你的默认货币（在 地址与税务 设置）计价。若卡是其他币种，按卡当日汇率换算。

自动充值帮不了的事

自动充值只维护余额。对以下场景无效：

• 订阅续费 — 续费日直接扣卡。卡失败时订阅进入自己的催款流程（7 天内重试 3 次，之后暂停）。
• API 限流错误 — 与余额无关。
• KYC 阻塞 — 与余额无关。

失败处理

自动充值扣款失败（拒付、风控、网络）：

1. 立即邮件告知，附卡组织返回的拒绝原因。
2. 触发请求以 insufficient_balance 失败。
3. 下次流量请求会再次试同卡。
4. 连续 3 次失败后自动充值暂停，需手动修复付款方式后再启用。

有备用卡时主卡 3 次失败后试备用卡。

会计接入

会计场景的常见诉求：

• 每次自动充值都对应独立发票（我们就是这么做的 ✓）
• 计费周期可预测（用订阅而非自动充值，可获得固定月账单）
• 聚合报表（用 报表 做月度汇总）

部分团队倾向完全关闭自动充值，只用订阅 + 月度发票，便于预算。这完全可行——把订阅档定在略高于月度流量即可。

相关

• 控制台设置：控制台 → 自动充值
• 订阅：订阅 API
• 退款：退款政策