开发时先使用
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。
创建账户 API 密钥
账户级接口要求人工 JWT 会话。API key 不能创建另一把 API key。根据组织 策略,还需要完成api_key_create OTP 挑战并发送 X-OTP-Token。
创建和管理账户 Webhook
创建账户 Webhook 使用同一资格门槛,并要求webhook_manage OTP:
GET /v1/webhooks/subscriptions 查看订阅。密钥不会返回。使用
PATCH /v1/webhooks/subscriptions/{subscriptionID} 发送
{"status":"disabled"} 或 {"status":"active"}。停用始终允许;重新启用
需要当前资格和 webhook_manage OTP。操作幂等,并且只影响未来事件,已排队
的投递仍会继续。
组织级订阅和管理员授权/对账操作请查看私有管理员文档与 Qbank 内部指南。
集成错误
参见错误目录和安全与 2FA。
个人账户可以使用 API key 吗?
个人账户可以使用 API key 吗?
可以,但管理员必须先为个人账户创建有效集成授权;账户还必须处于 active
并且 KYC 已批准。
企业账户需要授权吗?
企业账户需要授权吗?
不需要。企业账户的 KYB 批准后即可使用。
KYB 被拒或账户被阻止时会发生什么?
KYB 被拒或账户被阻止时会发生什么?
账户级 API key 会被撤销,账户 Webhook 会被停用。管理员可以运行组织对账
接口确认最终状态。
之后可以再次读取 token 吗?
之后可以再次读取 token 吗?
不可以。明文 token 只显示一次;丢失后请创建新 key 并撤销旧 key。