跳转到主要内容
POST
Create a Vault session
它和绑定银行卡是同一个托管绑卡流程,只是以 vault_id 契约提供给平台设置页,便于统一卡管理:创建会话 → 打开托管页面 → 重新读取卡列表。每次调用都会创建新的独立会话;不会创建购买授权,也不会创建指令。 POST /agent/platform/vault-sessions 与既有的绑定银行卡 POST /agent/platform/bind-sessions 创建的是同一个 Vault 绑定会话,只是响应字段名不同(这里是 vault_id,那里是 session_id)。新接入请使用 vault-sessions;bind-sessions 保留给既有接入,两者都不废弃。 请求中没有用于指定其他用户的 body 字段。会话始终为该 token 对应用户创建。
把 vault_id 和 url 当作凭证处理。不要转发、截图或写入日志;拿到其中任意一个的人可以在会话有效期内为该用户完成绑卡。只把它们发给目标用户。

用 vault_id 换取页面登录态

如果不想直接打开链接,可以用 vault_id 在既有兑换接口换取 Vault 页面登录态后再打开托管页面:
兑换接口返回 Vault 页面会话 token 及其 expire_in;该 token 只用于托管页面。会话有效期沿用 Clink 的 Vault 会话配置,过期后请重新创建会话。Vault 会话是绑卡会话,不是购买授权,不能用于向该用户扣款。

授权

Authorization
string
header
必填

Portal user token from POST /agent/cwallet/platform/portal/tokens. Reads require portal:read; writes require portal:write.

响应

Success

code
integer<int32>

200 on success.

示例:

200

msg
string

Result message.

示例:

"Success"

data
object