Skip to main content
账户级集成有明确的资格门槛。企业账户在 KYB 审批通过后可以使用 API 密钥和账户 Webhook。个人账户只有在组织管理员授予有效集成授权,并且 KYC 已审批通过后才可以使用。
开发时先使用 https://cryptobank.qbank.cl/platform 和 pk_test_... 凭证。 验证流程后再切换到 https://api.qbank.cl/platform 与正式凭证。

查询集成资格

创建凭证前先查询。响应会返回授权时间,但不会泄露管理员内部原因。
企业账户:
带有效授权的个人账户:
没有有效授权:
integration_kyb_required 表示账户身份验证尚未批准;account_blocked 表示账户状态不是 active。

注册时的邮箱域名黑名单

启用的黑名单域名会在以下流程被拒绝:
  • 密码注册 POST /v1/auth/register;
  • OAuth 新账户创建 POST /v1/auth/oauth(仅当供应商确认了邮箱);以及
  • 保存待定新邮箱之前的 POST /v1/me/email/change。
域名会被转为小写、删除末尾点并进行 IDN 转换;匹配是完整域名匹配:
已经绑定的 OAuth 身份仍可正常登录;黑名单只影响新账户创建流程。

创建账户 API 密钥

账户级接口要求人工 JWT 会话。API key 不能创建另一把 API key。根据组织 策略,还需要完成 api_key_create OTP 挑战并发送 X-OTP-Token。
明文 token 只返回一次。请放入密钥管理器,不要放在浏览器或源码中。

创建和管理账户 Webhook

创建账户 Webhook 使用同一资格门槛,并要求 webhook_manage OTP:
使用 GET /v1/webhooks/subscriptions 查看订阅。密钥不会返回。使用 PATCH /v1/webhooks/subscriptions/{subscriptionID} 发送 {"status":"disabled"} 或 {"status":"active"}。停用始终允许;重新启用 需要当前资格和 webhook_manage OTP。操作幂等,并且只影响未来事件,已排队 的投递仍会继续。 组织级订阅和管理员授权/对账操作请查看私有管理员文档与 Qbank 内部指南。

集成错误

参见错误目录和安全与 2FA。
可以,但管理员必须先为个人账户创建有效集成授权;账户还必须处于 active 并且 KYC 已批准。
不需要。企业账户的 KYB 批准后即可使用。
账户级 API key 会被撤销,账户 Webhook 会被停用。管理员可以运行组织对账 接口确认最终状态。
不可以。明文 token 只显示一次;丢失后请创建新 key 并撤销旧 key。
最后修改于 2026年9月19日