错误码

所有错误使用同一种响应结构。请根据数字 code 做分支判断；message 面向人阅读，内容可能变化。

更新于 2026年10月8日 · 阅读约需 6 分钟
Markdown

响应结构

{"error": {
  "code": 30001,                                                   
  "name": "not_enough_balance",                                    
  "message": "余额为 12.00 USDT，需要 26.00 USDT，请充值",                   
  "details": {"balance_usdt": "12.00", "required_usdt": "26.00"},  
  "request_id": "req_5f0c2a9e…"                                    
}}
  1. code — 五位数字：前两位表示类别，后三位是该类别中的错误编号。请根据它做分支判断
  2. name — 同一错误的文字名称
  3. message — 面向人阅读，使用中文并说明处理方法；内容可能变化
  4. details — 与该错误相关的数据；机器可读的原因在 details.problem 中
  5. request_id — 联系客服时请提供

未知错误码

根据前两位数字即可判断类别。如果是在创建订单时出错，请先调用 GET /v1/orders 检查订单是否已创建；然后把 request_id 提供给客服。

错误编号一经发布，含义不会改变，也不会被重复使用。

全部错误码

200 已接受401 · 403 访问权限404 · 405 · 410 对象不存在409 冲突或状态不符4xx 请求未通过402 · 429 资金与限额5xx 我方问题
10 · 密钥与访问5
401
10001 invalid_key
API 密钥未被接受：密钥缺失、不正确或已被吊销
请检查请求头 Authorization: Bearer <密钥>。如密钥已被吊销，请申请新密钥。
403
10002 key_scope_missing
该密钥无权执行此操作
需要有权访问该部分的密钥，请联系客服。
403
10003 ip_not_allowed
请求来源地址不在该密钥的允许列表中
请从允许列表中的服务器调用 API，或申请扩大允许列表。
403
10004 browser_not_allowed
API 只能从服务器调用，不能从浏览器调用
请把调用移到您的服务器上：在浏览器中使用过的密钥视为已泄露。
403
10005 account_suspended
合作伙伴账户已暂停，请联系客服
请联系客服。
11 · 请求6
404
11001 not_found
该地址不存在
请对照 API 参考检查路径。
405
11002 method_not_allowed
该地址不接受此请求方法
请对照 API 参考检查请求方法。
411
11003 length_required
需要 Content-Length 请求头
发送请求体时请带上 Content-Length。
413
11004 body_too_large
请求体过大
请求体不能超过 64 KB。
415
11005 unsupported_media_type
请求体必须是 JSON
请设置请求头 Content-Type: application/json。
422
11006 validation_error
请求未通过校验
具体问题见 details.errors：字段及原因。
20 · 限额5
429
20001 too_many_requests
请求过于频繁，请稍后重试
请等待响应头 Retry-After 中给出的秒数后再试。
429
20002 too_many_orders
每分钟下单过多，请稍后重试
请等待 Retry-After 秒。限额见 GET /v1/account。
429
20003 too_many_activation_attempts
该订单的开通尝试次数过多，请稍后重试
请等待 Retry-After 秒。每次尝试都会提交给服务方，请不要循环重试。
429
20004 daily_order_limit_reached
今日下单数量已达上限
新订单请在 UTC 时间 00:00（莫斯科时间 03:00）之后提交。需要更多额度请联系客服。
429
20005 daily_spend_limit_reached
今日支出已达上限
还可支出的金额见 GET /v1/balance 中的 available_today_usdt。额度在 UTC 时间 00:00 重置。
30 · 余额1
402
30001 not_enough_balance
余额不足以支付该订单
请充值（地址见 GET /v1/balance/top-up-addresses）后重试。
40 · 商品6
404
40001 product_not_found
商品目录中没有该商品
请从 GET /v1/catalog 获取 product_id。
409
40002 out_of_stock
该商品暂时缺货
请稍后重试，库存情况可在商品目录中查看。
409
40003 card_payment_queue_full
由我方银行卡代付的队列目前已满
请稍后在队列有空位时重试。
409
40004 no_email_for_new_account
暂时无法创建新账号：没有可用的邮箱
请稍后重试，或选择其他交付方式。
422
40005 delivery_method_required
该商品有多种交付方式，请指定 delivery_method
商品的交付方式见 details.delivery_methods 及商品目录。
422
40006 delivery_method_unavailable
该商品没有这种交付方式
商品的交付方式见 details.delivery_methods 及商品目录。
50 · 订单8
404
50001 order_not_found
订单不存在
请检查 order_id：只能看到您的密钥创建的订单。
409
50002 goods_already_taken
商品已交付，订单无法取消
如商品有问题，请在交付后 7 天内提交售后申请：在后台提交，或调用 POST /v1/orders/{order_id}/claims。
409
50003 customer_data_already_sent
客户信息已提交，订单无法取消
请等待开通结果；如有问题请联系客服。
409
50004 order_already_closed
订单已关闭
订单状态见 GET /v1/orders/{order_id}。
409
50005 order_in_progress
订单已在处理中，无法取消
新账号从下单第一分钟起由工作人员处理。如有问题请联系客服。
409
50006 claim_not_available
该订单无法提交售后申请
原因见 details.problem：window_closed（交付已超过 7 天）、not_completed（订单尚未完成）、closed（订单已取消或已退款）。
409
50007 claim_already_open
该订单已有待回复的售后申请
请等待处理结果：结果会通过 order.updated 事件通知，申请详情见 GET /v1/claims。
404
50008 claim_not_found
售后申请不存在
请检查 claim_id：只能看到您订单的售后申请。
60 · 开通8
409
60001 order_has_no_activation
该订单没有开通流程
卡密和账号会立即交付，请通过 GET /v1/orders/{order_id} 获取。
409
60002 not_waiting_for_data
订单当前不需要客户信息
当前进展见订单的 status_text，可执行的操作见 available_actions。
409
60003 retry_not_available
现在无法重试
可执行的操作见订单的 available_actions。
409
60004 force_not_available
现在无法覆盖当前套餐开通
可执行的操作见订单的 available_actions。
422
60005 invalid_customer_data
客户信息不符合要求
message 是可直接展示给客户的文字，机器可读的原因见 details.problem。
422
60006 invalid_login_link
登录链接不符合要求
message 是可直接展示给客户的文字：请客户从邮件中完整复制链接。
409
60007 verification_not_requested
服务方没有要求客户进行身份验证
可执行的操作见订单的 available_actions。
200
60100 customer_data_unusual
格式不常见，请确认提交的内容是否正确
信息已接收。请确认客户提交的是所要求的内容。
70 · Webhook3
409
70001 webhook_not_set
未设置 Webhook 地址
请设置：PUT /v1/webhook。
422
70002 webhook_url_invalid
Webhook 地址未通过校验
需要公网 https 地址；原因见 details.problem。
429
70003 too_many_webhook_tests
测试事件发送过多，请稍后重试
请等待 Retry-After 秒。
80 · 沙盒与密钥领取9
410
80001 key_link_expired
密钥领取链接已过期，请申请新链接
请申请新链接。
410
80002 key_link_used
密钥领取链接已被使用，请申请新链接
密钥只显示一次；如已丢失，请申请新密钥。
429
80003 sandbox_address_limit
该地址 24 小时内领取的沙盒密钥已达上限
请在 Retry-After 之后重试。
429
80004 sandbox_day_limit
今日沙盒密钥已发放完毕，明天会有新的
请明天再试。
503
80005 sandbox_closed
沙盒密钥目前暂停发放
请稍后重试。
422
80006 sandbox_unknown_network
沙盒中没有这个网络
网络列表见 GET /v1/balance/top-up-addresses。
422
80007 sandbox_top_up_too_large
单次测试充值金额过大
请减小 amount_usdt。
429
80008 sandbox_top_up_daily_limit
今日测试充值额度已用完
请明天再试。
409
80009 active_key_limit
该合作伙伴的有效 API 密钥数量已达上限
请联系我们吊销其中一个 API 密钥。
90 · 我方故障4
500
90001 internal_error
内部错误，请稍后重试
请稍后重试。如果是在创建订单，请先通过 GET /v1/orders 确认订单是否已创建。
503
90002 api_disabled
API 暂时关闭
请稍后重试。
503
90003 exchange_rate_unavailable
暂时无法计算价格，请稍后重试
请稍后重试。
409
90004 try_again
首次请求未成功，请重试
请重试请求；余额未被扣款。

错误示例

示例：余额不足

{
  "product_id": "3f6c0e7e-2b1d-4c1a-9a57-4d0f1b8e2c11"
}

{
  "error": {
    "code": 30001,
    "name": "not_enough_balance",
    "message": "余额为 4.00 USDT，需要 20.00 USDT，请充值",
    "details": {
      "balance_usdt": "4.00",
      "required_usdt": "20.00"
    },
    "request_id": "req_5f0c2a9e41d7b3a8"
  }
}
本页内容是否有帮助？
发现错误？在 Telegram 联系我们
上一篇事件与 Webhook下一篇沙盒