发送已签署入会协议

简介

本资源旨在向我们发送投资者对某基金发行系列的入会协议签署证明。

注意

本资源仅适用于担任分销商角色的集成。

作为输入，需发送投资者已入会的基金发行系列 UUID、签署类型，以及根据签署方式进行验证所需的内容。示例如下。

作为输出，将返回 investor_adhesion_key。investor_adhesion_key 用于标识投资者入会。入会创建时即为 active 状态。

ENDPOINT

/investor_adhesion/investor/INVESTOR_KEY/signed_investor_adhesion

MÉTODO

POST

STATUS

201

请求体
{
  "issuance_serie_key": "UUID",
  "signature_method": "opt_in",
  "opt_in_hash" : "OPT_IN_HASH"
}

字段	类型	描述	字符数	必填
`issuance_serie_key`	string	投资者已入会的发行系列键	36	是
`signature_method`	string	所用签署方式：`opt_in` 或 `external`	最多100	是
`opt_in_hash`	string	opt-in 哈希值。当 `signature_method` 为 `opt_in` 时必填	最多500	否
`document_b64`	string	以 base64 编码的已签署协议。当 `signature_method` 为 `external` 时必填	-	否
`signer_group_key`	string	投资者签署人组键。如省略，则使用投资者的默认签署人组	36	否

注意

在集成过程中，将要求提供对所发送哈希值进行认证的方式。

响应体
{
    "investor_adhesion_key": "UUID"
}

状态	代码	发生情形
400	`IAD000027`	投资者分类不允许入会该系列
400	`IAD000037`	`signature_method` 为 `opt_in`，但未发送 `opt_in_hash`
400	`IAD000038`	`signature_method` 为 `external`，但未发送 `document_b64`
400	`IAD000039`	该投资者已存在对此发行系列的入会
400	`IAD000051`	投资者没有签署人组（或 `signer_group_key` 不存在）
400	`IAD000054`	投资者处于非运营状态
400	`QIT000011`	该集成不是该投资者的分销商
404	`IAD000012`	未找到投资者
404	`IAD000018`	未找到发行系列

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