跳到主要内容

转让方账户

放款账户可以在转让方注册时（accounts）一并提交，也可以之后通过本页面添加。转让方至少需要有一个账户，才能提出转让合同。在管理人审批转让的环节，可以指定该转让方的任一已注册账户进行放款。

与代表、地址等其他注册数据不同，修改转让方账户不会创建新的审查，因此修改立即生效。对于放款账户，账户持有人必须是转让方本人（包括账户所有权），且默认账户所有人的证件号即为转让方的证件号。

注意

填写账户数据时务必谨慎。如果账户无效，转让付款将无法完成，整个业务将被取消。

管理人不能通过 API 维护账户

manager-api 不提供账户相关路由。转让方账户由顾问（consultant-api）或转让方本人（assignor-api）维护。需要添加或停用账户的管理人，应在转让方初始注册时（accounts）一并提交，或请顾问或转让方处理，或联系集成团队 integracao.dtvm@qitech.com.br。

添加备用账户​

适用范围
角色主机所需权限
顾问consultant-apiRegister Assignor
转让方assignor-api写入

各主机的 Base URL：环境（主机）。

Request​

ENDPOINT
/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEY/account
MÉTODO
POST
Request Body
{
    "account_number": "8473124",
    "account_digit": "8",
    "account_branch": "0001",
    "account_type": "checking_account",
    "financial_institution_code": "329",
    "default_account": false
}

账户对象​

字段类型描述字符数
account_number *string账号。3-20
account_digit *string账户校验位。1
account_branch *string账户所属分行。4
account_type *string账户类型。-
financial_institution_code *string账户所属银行的代码。3
default_account *boolean默认放款账户。-

*必填字段。

Response​

STATUS
201
Response Body
{
    "account_key": "3c53a94a-2b81-4837-b7eb-8e025e69d81c",
    "account_branch": "0001",
    "account_number": "8473124",
    "account_digit": "8",
    "account_type": "checking_account",
    "status": "active",
    "financial_institution_code": "329",
    "financial_institution_ispb": "32402502",
    "default_account": false
}
信息

如果新账户以 "default_account" true 提交，原默认放款账户将变为非默认账户，此后新提交的账户即为默认放款账户。

错误​

状态码代码触发条件
404ASR000004未找到所提供 assignor_registry_key 对应的转让方。请检查 assignor_registry_key 是否正确。
409ASR000072已存在银行、分行、账号和校验位组合相同的有效账户。请勿提交重复账户——请检查该转让方已注册的账户。
400ASR000087账户信息只能包含数字。account_branch、account_number、account_digit 和 financial_institution_code 只能填写数字。
404ASR000071未找到金融机构。请核实所提供的 financial_institution_code（银行代码）。

认证、权限和主机相关错误：参见 API 错误。

更新账户​

账户数据无法修改。如有需要，请停用错误的账户，并使用正确的数据创建新账户。

如需更改默认放款账户，只需指定新的账户，原账户会自动变更。不能将某个账户设为非默认放款账户，必须始终指定新的默认账户。

适用范围
角色主机所需权限
顾问consultant-apiRegister Assignor
转让方assignor-api写入

各主机的 Base URL：环境（主机）。

Request​

ENDPOINT
/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEY/account/ACCOUNT_KEY
MÉTODO
PUT
Request Body
{
    "status": "active",
    "default_account": true
}

账户对象​

字段类型描述字符数
statusstring账户的新状态。见 账户状态枚举值。
default_accountboolean只接受 true：将该账户设为默认放款账户。-

两个字段至少发送一个。

Response​

STATUS
200
Response Body
{
    "account_key": "3c53a94a-2b81-4837-b7eb-8e025e69d81c",
    "account_branch": "0001",
    "account_number": "8473124",
    "account_digit": "8",
    "account_type": "checking_account",
    "status": "active",
    "financial_institution_code": "329",
    "financial_institution_ispb": "32402502",
    "default_account": true
}
信息

如果更新时提交 "default_account" true，原默认放款账户将变为非默认账户，此后该账户即为默认放款账户。不能停用默认账户，也不能将未启用的账户设为默认账户。

错误​

状态码代码触发条件
404ASR000004未找到所提供 assignor_registry_key 对应的转让方。请检查 assignor_registry_key 是否正确。
404ASR000073未找到所提供 account_key 对应的账户。请检查该 account_key 是否属于该转让方。
400ASR000074不能停用/取消默认账户。请先将另一个账户设为默认账户（在另一个账户上设置 default_account=true），再停用当前账户。
400ASR000075未发送任何要更新的信息。请在请求体中提供 status 或 default_account。

认证、权限和主机相关错误：参见 API 错误。

枚举值​

Account Status​

枚举值描述
active账户已启用，可作为放款选项。
inactive账户未启用，不可用于放款。