跳转到主要内容
POST
Create a card session
返回的 token 是浏览器会话,不是 portal token:portal token 仍只保留在服务端。scope 为 card:manage,该 token 只能访问下方列出的卡管理接口;其他 /a/** 接口会返回 403 和 browser_scope_forbidden(code 71211020),包括读取交易、客户资料或执行其他卡片操作。/agent/** 需要 portal token,网关会以 401 拒绝该浏览器会话。 请求没有 body 字段。会话始终为该 token 对应用户创建。 默认有效期为 30 分钟。token 过期后请重新调用本接口;不要复用已过期的 token。

允许访问的接口

  • GET /a/cwallet/card/info:查询用户的卡列表。
  • PUT /a/cwallet/card/setDefault:设置默认卡。
  • DELETE /a/cwallet/card/delete:删除卡片。
  • GET /a/cwallet/get/countryAlpha2Code:按客户端 IP 解析的二字国家码,用于卡片表单预选国家。
  • GET /a/cwallet/kms/public-key:获取页内加卡表单加密卡数据所需的公钥;加密结果通过同一会话的 POST /a/cwallet/card/add 提交。
  • POST /a/cwallet/card/add:添加卡片;需要 3-D Secure 时返回 action。
  • POST /a/cwallet/redirect/callback:完成加卡的 3-D Secure 回调。
添加卡片支持在本卡管理会话内完成:card/add 返回 3-D Secure action 后,由 redirect/callback 收口。该回调接口同时可能推进购买授权,因此 token 只能用于客户自己的浏览器,不能跨客户共享。Vault 会话(见创建 Vault 会话)仍然是可选的托管绑卡路径。除上述 7 个接口外,本会话不开放其他卡片/交易/客户数据操作。
把 access_token 当作凭证处理。不要写入日志、在用户之间共享或发送给模型。只在用户自己的浏览器会话中使用,并为不同用户重新申请。

授权

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