📄 正文
在 DeCard 托管模式下，用户（Account）是整个发卡体系的身份基准：它承载终端用户的标识 externalUserId、合规状态与交易限制，开卡、充提、消费等所有能力都以它为锚点。作为持牌、自有 BIN 的发卡机构，DCS 在风控与合规侧统一管理用户的交易限制，并通过标准化接口供您随时查询。
本页面向用户创建之后的日常管理——查询用户当前的交易限制状态（是否禁止提现 / 禁止卡交易），并作为用户全生命周期各能力的导航入口。如需用户注册，请前往 用户注册。
用户生命周期一览
终端用户从注册到管理，各能力分布在不同页面。本页聚焦「用户状态/交易限制」，其余环节请前往对应页面：
DCS 承担什么
为保障平台金融操作的合规性与安全性，DCS 会对用户施加交易限制（如禁止提现、禁止卡交易），并提供标准化接口供您随时查询用户的当前限制状态。限制的设置规则与触发条件由 DCS 风控/合规侧管理，接入机构通过本接口读取结果，在自有系统中据此引导用户。
查询用户状态
用查询接口读取某个用户当前的交易限制：是否禁止提现、是否禁止卡交易。
前置条件
- 您已持有企业（Enterprise）的
ApiKey / SecretKey。若尚未领取，请参阅前置准备。
- 您已有目标用户的
externalUserId（注册用户时由 DCS 生成）。
GET /account/v1/user-status
查询参数
请求示例
鉴权头的生成方式见前置准备。
示例中 externalUserId 使用脱敏占位 u_*****，请替换为真实用户 ID（切勿在文档/日志中记录真实 PII）。
响应示例（200）
data 字段（用户状态 / 交易限制）
如何使用：当 forbidWithdraw=true 时应在自有系统中拦截/隐藏提现入口；当 forbidCardTransaction=true 时应提示用户当前卡交易受限。两者相互独立。
统一响应结构
所有 /account/ 接口返回统一结构，本接口业务数据置于 data：
集成时以 code（SYS_SUCCESS）判断系统调用是否成功，以 data 内字段判断用户的业务状态。
错误处理
所有 /account/ 接口使用统一响应结构。以 code 字段判断调用成功与否：
code = SYS_SUCCESS → 调用成功，业务数据在 data 中code ≠ SYS_SUCCESS → 调用失败，应读取 message 与 messageDetail（title / message / type 等）了解失败原因
典型错误场景
下表为网关/参数层错误。业务层失败通常仍返回 HTTP 200，请以响应 code 判定业务结果。
注意：以上 HTTP 状态码为典型场景分类。确切错误码与 messageDetail 展示信息以实际返回为准；集成时不应以未列出的错误码做硬编码校验。
资产与余额
本页只覆盖用户状态/交易限制。用户的资金账户（可用余额 free / 冻结余额 freeze / 总额 total、充值 credit、扣款 debit、资产流水）属于余额域，不在此页重复展开——请前往：
下一步
