# 自动充值

本页讲计费侧概念与政策；控制台设置流程见 [控制台 → 自动充值](/helodata-zh/kong-zhi-tai/auto-topup.md)。

## 是什么

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

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

## 与发票的关系

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

```
Top-up — auto, threshold $50                $200.00
```

格式与处理与其他付费事件一致——见 [发票](/helodata-zh/zhang-hu-yu-ji-fei/invoices.md)。

## 与退款的关系

自动充值**仅未消耗部分可退**，规则同手动充值——见 [退款政策](/helodata-zh/zhang-hu-yu-ji-fei/refunds.md)。已通过代理流量消耗的部分不退。

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

## 日上限是保险

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

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

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

## 多币种交互

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

## 自动充值帮不了的事

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

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

## 失败处理

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

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

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

## 会计接入

会计场景的常见诉求：

* 每次自动充值都对应独立发票（我们就是这么做的 ✓）
* 计费周期可预测（用**订阅**而非自动充值，可获得固定月账单）
* 聚合报表（用 [报表](/helodata-zh/api-can-kao/reports.md) 做月度汇总）

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

## 相关

* 控制台设置：[控制台 → 自动充值](/helodata-zh/kong-zhi-tai/auto-topup.md)
* 订阅：[订阅 API](/helodata-zh/api-can-kao/subscriptions.md)
* 退款：[退款政策](/helodata-zh/zhang-hu-yu-ji-fei/refunds.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helodata.com/helodata-zh/zhang-hu-yu-ji-fei/auto-topup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.