# 修复"额度不足"错误

Source: https://help.didit.me/zh/billing-credits/not-enough-credits
Updated: 2026-10-31

你的套餐额度和余额已用完，或者工作流包含了免费套餐额度无法支付的检查。这里介绍如何找出是哪一项，以及如何避免它再次发生。

你本月的套餐额度和充值余额无法覆盖工作流中的某项检查。当工作流包含**白标**（$0.20）、
AML（$0.20）、NFC（$0.15）或主动活体检测（$0.15）时，免费套餐每月 $10 的额度会比预期更快用完。
在充值之前，先打开工作流，看看启用了什么。

如果一次核验请求失败并返回 `"You don't have enough credits to perform this request"`，或者在你创建会话时 API 返回错误代码 `insufficient_credits`，说明你组织的余额无法覆盖工作流正在尝试运行的某项功能。同样的原因也可能表现为一个**"额度不足"错误（有时是 502）**，例如工作流包含手机核验或数据库验证，而免费套餐额度不能支付这两项。

## 先检查工作流，再检查余额

本能反应是先看用量。但请先看你的**工作流**，因为每个已启用的模块都从你每月 $10 的额度（免费套餐）中扣费，然后才是余额，而且有些模块比基础四项（证件核验、被动活体检测、1:1 人脸匹配和设备与 IP 分析，合计 $0.33）贵得多。以下是最常见的元凶，按实际出现频率排序：

| 功能 | 价格 | 为什么会让人意外 |
|---|---|---|
| **白标 / 品牌定制** | 每次核验 $0.20 | 这是一项外观设置，感觉上不像一次"检查" |
| **AML 筛查** | $0.20 | 经常在没注意的情况下被添加到基础 KYC 模板中 |
| **NFC** | $0.15 | 与证件核验分开计费 |
| **主动活体检测** | $0.15 | 从被动切换到主动后，价格会上涨。在工作流中，主动方式是 **3D Flash** 和 **3D Action & Flash**；**Passive Liveness** 为 $0.10 |
| **年龄估算** | $0.10 | 它与证件核验分开定价 |
| **问卷** | $0.10 | 感觉像一份表单，而不是一次检查 |
| **手机核验** | 起价 $0.03 + 运营商费用 | 运营商费用因目标地区而异 |
| **邮箱核验** | $0.03 | |
| **地址证明** | $0.20 | |
| **数据库验证** | 因国家/地区而异 | 在运行之前还需要完成**首次充值** - 免费套餐额度不算在内。参见[数据库验证](https://help.didit.me/zh/documents-coverage/database-validation) |
| **企业核验（KYB）** | 因国家和登记信息层级而异 | |

> **Warning:** **白标是最常见的原因，没有之一。** 一个启用了自定义品牌的工作流，每次完成的核验都要
> 在各模块价格**之上**再收取 $0.20 - 因此你原本按普通 KYC 搭建的流程，一旦加上品牌定制，
> 每次会话的费用就会立刻增加约 60%。参见[定制品牌形象](https://help.didit.me/zh/workflows/customize-branding-and-experience)。

## 解决方法

1. **打开失败会话所使用的工作流**

   不是随便一个工作流 - 而是该会话创建时所使用的那个 workflow ID。在**工作流程**中，
   对照上表逐一检查每个已启用的功能。

2. **找到隐藏的自定义样式开关**

   白标是一项名为 **Include custom style** 的按工作流设置，它不在步骤列表中，这就是为什么逐一审查步骤永远找不到它。在工作流编辑器中，它是**顶部栏中色板图标旁边的小开关，而且只有当鼠标悬停在该图标上时才会出现**，因此一个工作流可能已经启用了品牌定制，却没有人记得做过这件事。同一项设置也位于工作流的 **Settings** 侧边栏中，在那里它始终可见。

3. **检查你的余额**

   **设置 → 账单和套餐**显示你当前的余额。如果本月额度已用完且余额为零或负数，所有计费工作都会停止，
   直到余额恢复到零以上。

4. **要么移除付费功能，要么充值**

   如果你不需要这项付费功能，关闭它并重新发布。如果需要，请充值 - 最低充值金额为 $50。
   参见[充值、发票与付款方式](https://help.didit.me/zh/billing-credits/top-ups-invoices-and-payments)。

![Didit 控制台中的账单页面，展示账户余额和充值按钮](https://help.didit.me/screenshots/billing-credits-light.webp)

*检查余额没错，但请先检查工作流中的付费功能。*

## 值得排查的其他原因

- **余额为负。** 一旦余额降到零以下且你本月的额度已用完，正式环境的检查就会停止。这是该错误确实与某个具体模块无关的情况。
- **用错了应用的密钥。** 余额是按组织计算的，但如果你使用的密钥所属应用的工作流，与你审查的工作流不同，那你看的就是错误的配置。参见[组织、应用与环境](https://help.didit.me/zh/account-organization/organizations-and-applications)。
- **这是独立 API 调用，而不是工作流会话。** 独立调用按标价按次计费，使用相同的额度和余额，因此可能比你预期的更快用完。
- **尚未充值就使用手机核验或数据库验证。** 两者在你的组织完成首次真实充值之前都处于未启用状态；免费套餐额度无法解锁它们。参见[充值、发票与付款方式](https://help.didit.me/zh/billing-credits/top-ups-invoices-and-payments)。
- **沙盒能用而正式应用不能用。** 沙盒从不计费，因此暴露不出付费功能。工作流的真实价格在第一个正式会话中才会显现。
- **你确实用完了本月的 $10。** 在下结论之前，先到 Analytics 中查看当月各功能的用量，并到用量页面查看每次检查的扣费。额度在每月 1 日重置。

## 避免再次发生

- 在**设置 → 账单和套餐**中**开启自动充值**，让余额在低于你设定的阈值时自动补充。
- **在 sandbox 中测试**，那里不产生任何计费，余额检查也会被完全跳过。参见[在 sandbox 中测试](https://help.didit.me/zh/getting-started/sandbox-and-testing)。
- **将测试应用和 live 应用分开**，避免一次实验耗尽生产流量所依赖的余额。

## 设置支出上限

如果你想设置一个硬性上限，让账户在测试期间无法变为负数，这属于账户级别的控制项，而不是工作流设置 - 请向支持团队咨询你的组织可用哪些选项。与此同时，实用的做法是：继续在 sandbox 应用中测试，那里没有任何东西会产生花费。

## 如果充值不能自助完成

年付套餐的组织无法通过自助充值流程购买额度 - 请联系你的客户经理。自助尝试会明确告诉你这一点，而不是静默失败。

## 如果你的余额看起来不对

如果你的余额、发票或核验历史突然显示缺失或不正确，这几乎总是平台的临时问题，而不是数据丢失。请联系支持团队，不要自行尝试修复，并附上你的组织 ID。