修复"额度不足"错误
几乎总是由工作流中某项你以为是免费的付费功能引起 - 白标、AML、NFC 或主动活体检测。这里介绍如何找出是哪一项,以及如何避免它再次发生。
十有八九,这不是免费额度用完了。而是工作流中包含了付费功能 - 最常见的是 白标($0.20)、AML($0.20)、NFC($0.15)或主动活体检测($0.15)。在充值之前, 先打开工作流,看看启用了什么。
如果一次核验请求失败并返回 "You don't have enough credits to perform this request",说明你组织的余额无法覆盖工作流正在尝试运行的某项功能。
创建会话时,API会以错误代码insufficient_credits报告同一情况。两点能减少工单的说明:在工作流中,主动活体检测方式叫3D 闪光和3D 动作与闪光,只有被动活体检测是免费的;数据库验证和电话验证在运行前还需要首次充值(10美元欢迎赠金不算)。参阅数据库验证。
#先检查工作流,再检查余额
本能反应是先看用量。但请先看你的工作流,因为免费额度只覆盖以下四项功能,每项每月各自享有 500 次免费额度:
- 证件核验
- 被动活体检测
- 1:1 人脸匹配
- 设备与 IP 分析
其他任何模块从第一次检查起就会计费,与用量无关。以下是最常见的元凶,按实际出现频率排序:
| 功能 | 价格 | 为什么会让人意外 |
|---|---|---|
| 白标 / 品牌定制 | 每次核验 $0.20 | 这是一项外观设置,感觉上不像一次"检查" |
| AML 筛查 | $0.20 | 经常在没注意的情况下被添加到"免费 KYC"模板中 |
| NFC | $0.15 | 与证件核验分开计费 |
| 主动活体检测 | $0.15 | 从被动切换到主动后,就不再属于免费额度 |
| 年龄估算 | $0.10 | 免费额度中的证件核验不包含它 |
| 问卷 | $0.10 | 感觉像一份表单,而不是一次检查 |
| 手机核验 | 起价 $0.03 + 运营商费用 | 运营商费用因目标地区而异 |
| 邮箱核验 | $0.03 | |
| 地址证明 | $0.20 | |
| 数据库验证 | 因国家/地区而异 | |
| 企业核验(KYB) | $2.00 |
白标是最常见的原因,没有之一。 一个启用了自定义品牌的工作流,每次完成的核验都要 在各模块价格之上再收取 $0.20 - 因此你原本按免费 KYC 搭建的流程,一旦加上品牌定制, 就会立刻变成付费流程。参见定制品牌形象。
#解决方法
- 打开失败会话所使用的工作流
不是随便一个工作流 - 而是该会话创建时所使用的那个 workflow ID。在 Workflows 中, 对照上表逐一检查每个已启用的功能。
- 别忘了检查 Options 标签页
白标是在 Settings → Options → Include custom style 下按工作流启用的,而不在步骤列表中, 因此在审查步骤时很容易被漏掉。
- 检查你的余额
Settings → Billing 显示你当前的余额。如果是负数,所有计费工作都会停止 - 包括你的免费额度检查 - 直到余额恢复到零以上。
- 要么移除付费功能,要么充值
如果你不需要这项付费功能,关闭它并重新发布。如果需要,请充值 - 最低充值金额为 $50。 参见充值、发票与付款方式。

- 增加额度会立即清除该错误。
- 在认定余额有问题之前,先确认充值确实已到账。
#值得排查的其他原因
-
余额为负。 一旦余额降到零以下,免费额度的检查也会停止。这是该错误确实与付费功能无关的情况。
-
用错了应用的密钥。 余额是按组织计算的,但如果你使用的密钥所属应用的工作流,与你审查的工作流不同,那你看的就是错误的配置。参见组织、应用与环境。
-
这是独立 API 调用,而不是工作流会话。 独立调用按次计费,没有免费额度,即使这项功能在工作流中是免费的。
-
你确实用完了某项功能的 500 次额度。 在下结论之前,先到 Analytics 中查看当月各功能的用量 - 并记住四项功能各自拥有独立额度,所以在低用量时,这是可能性最小的原因。
-
尚未充值就使用电话验证或数据库验证。 两者在您的组织完成首次真实充值前都处于未启用状态,欢迎赠金无法解锁它们。参阅充值、发票和支付方式。
-
沙盒能用而正式应用不能用。 沙盒从不计费,因此暴露不出付费功能。工作流的真实价格在第一个正式会话中才会显现。
#避免再次发生
- 在 Settings → Billing 中开启自动充值,让余额在低于你设定的阈值时自动补充。
- 在 sandbox 中测试,那里不产生任何计费,余额检查也会被完全跳过。参见在 sandbox 中测试。
- 将测试应用和 live 应用分开,避免一次实验耗尽生产流量所依赖的余额。
#设置支出上限
如果你想设置一个硬性上限,让账户在测试期间无法变为负数,这属于账户级别的控制项,而不是工作流设置 - 请向支持团队咨询你的组织可用哪些选项。与此同时,实用的做法是:继续在 sandbox 应用中测试,那里没有任何东西会产生花费。
#如果充值不能自助完成
年付套餐的组织无法通过自助充值流程购买额度 - 请联系你的客户经理。自助尝试会明确告诉你这一点,而不是静默失败。
#如果你的余额看起来不对
如果你的余额、发票或核验历史突然显示缺失或不正确,这几乎总是平台的临时问题,而不是数据丢失。请联系支持团队,不要自行尝试修复,并附上你的组织 ID。
