更新银行账户状态
简介
本资源更改注册分析中已登记银行账户的状态——例如,停用不应再使用的账户。
账户通过其外部密钥(external_bank_account_key)识别,该密钥在创建时返回。
适用范围
| 角色 | 主机 |
|---|---|
| 分销商 | distributor-api |
各主机的 Base URL:环境(主机)。
Request
ENDPOINT
/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/bank_account/{external_bank_account_key}/statusMÉTODO
PUTSTATUS
202Request body
请求体
{
"status": "inactive"
}
Body params
| 字段 | 类型 | 说明 | 必填 |
|---|---|---|---|
status | string | 账户的新状态。常见取值:active、inactive | 是 |
Response
202 Accepted。响应体返回更新后的账户信息。
错误
| 状态 | 代码 | 发生情形 |
|---|---|---|
| 400 | IVR000185 | 分析已结束(已批准、已拒绝、已完成或已取消) |
| 404 | IVR000181 | 未找到该 external_bank_account_key 对应的账户 |
| 400 | IVR000075 | status 取值无效 |
| 400 | IVR000074 | 无法停用主账户 |
认证、权限和主机相关错误:参见 API 错误。