故障排查
充值、订单、自动化或 Webhook 出现异常时该怎么办。
充值
我的充值没有到账
请按以下清单逐项排查：
- 给网络一点时间。 到账发生在充值在链上确认之后，而不是你点击发送的那一刻。
- 检查所用的链。 充值地址是 TRON（TRC-20）。从以太坊、BNB Chain 或交易所内部网络发送的 USDT 永远到不了这里，也无法找回。
- 检查最低金额。 低于充值对话框中所示最低金额的充值可能不会到账。
- 检查地址。 必须是你自己的充值对话框中的地址，而不是来自某篇指南或某张截图中的地址。
到账后，你会收到 deposit.credited 通知，并且它会出现在钱包中。
我可以直接充值 TRX 吗？
可以。余额以 TRX 计价，所以 TRX 充值完全不需要转换。USDT-TRC20 会在到账时按当前汇率转换。
订单
我的订单显示 Created，而不是 Filled
短时间内这是正常的。我们收款并开始交付时，订单为 Created；交付确认后变为 Filled，通常在几秒内。
不要循环刷新它。它会自行完成结算，你会收到通知（或 order.filled Webhook）。
我的订单失败了，钱去哪了？
回到了你的余额。失败的订单会自动退款；你会在钱包中看到这笔退款，并收到 order.failed 通知。如果余额没有体现，请把订单编号告诉我们。
为什么实际费用比预览显示的更高？
几乎都是因为地址激活：从未在 TRON 上发生过交易的地址必须激活一次，这会额外产生 2 TRX。只有在你读取数字之前已经填写了地址，预览才会把它计算在内。填好地址后重新预览，金额就会一致。
能量到账了，但后来消失了
租用的能量是临时的：你所选的租期届满后，它就会归还。如果需要它一直保留，请租用更长时间，或使用自动化来持续补充。
自动化
我的规则自己暂停了
你的余额不足以支付下一次交付，所以我们选择暂停它，而不是让它失败。请充值，然后恢复。
开启自动恢复后，这种情况会自行解决：被系统暂停的规则会在你的余额再次足以支付一次交付时重新启动。你手动暂停的规则则永远不会自动恢复，这是有意为之。
我已经充值了，但规则没有恢复
请检查三件事：
- 自动恢复开了吗？ 它需要按每条规则单独选择开启。
- 余额够一次完整交付吗？ 如果余额不足以支付一次触发，恢复后只会再次暂停，所以不会恢复。
- 是谁暂停的？ 如果是你手动暂停的，只有你才能重新启动。
我的规则处于启用状态，但没有任何交付
对于启用中的规则，如果安静的时间超出了其计划应有的间隔，我们会在内部检测并标记。如果某个地址没有获得能量，而规则看起来一切正常，请带上规则和地址联系我们。不要直接删除再重建，因为那会丢失我们用来诊断的历史记录。
我可以为带宽设置自动化吗？
不可以。自动化仅限能量，带宽只能一次性购买。请在购买能量页面手动下单。
API 与智能体
403 api_key.insufficient_scope
该密钥无权执行此操作。权限范围是层层包含的：full ⊇ purchase ⊇ read。读取需要 read，花费（订单、自动化）需要 purchase，管理 Webhook 需要 full。请签发具有相应权限范围的密钥，参见身份验证。
403 api_key.spend_limit_exceeded
该密钥达到了每日消费限额。限额按每个密钥、每个 UTC 自然日计算，同时统计该密钥下的订单，以及该密钥所创建自动化产生的交付。请提高限额，或等待日期切换。
这是按设计运作的，正是这道防护栏让你可以放心地把密钥交给智能体。
402 wallet.insufficient_balance
TRX 不足。创建续期规则或启用智能模式时也会触发，因为这两者都要求预先有足够支付至少一次交付的余额。
我丢失了 API key
密钥只显示一次，并以哈希方式存储，我们无法找回。请吊销它并签发新的密钥。
Webhooks
我收不到投递
请先在控制台查看该端点的投递日志，它会显示每次尝试以及我们收到的响应。然后检查：
- 端点是否已启用？ 已禁用的端点会被静默跳过。
- 你返回的是 2xx 吗？ 其他任何响应都视为失败并会重试（约 30 秒 → 6 小时，最多 6 次），之后该投递会被标记为失败。
- 你订阅了该事件吗？ 端点只会收到你为它选择的事件类型。
- 发送一次测试 ping，端到端检查链路是否通畅。
添加端点时就失败了？
我们只接受公网 HTTPS URL。添加端点时，
http://、localhost以及私有或内部 IP 地址都会被拒绝，所以如果你在本地开发，请在接收端前面架设一个隧道。
签名验证失败
几乎总是以下原因之一：
- 你验证的是解析后的正文。 请对原始字节签名，在任何 JSON 解析或重新序列化之前，重新编码后的正文空白字符不同，HMAC 就无法匹配。
- 你漏掉了时间戳。 被签名的字符串是
{timestamp}.{rawBody}，而不只是正文。 - 你轮换了密钥，而接收端仍在使用旧密钥。
格式和完整示例见 Webhooks 参考。
我收到了两次相同的事件
这是有意为之：重试意味着至少一次投递。请根据 X-TronGas-Delivery 请求头去重。