Send Signed Adhesion Term

Introduction

This resource is used to send us the proof of signature of an investor's adhesion term to a fund's issuance series.

Attention

This resource is available only for integrations acting as Distributor.

Input / Output:

As input, the UUID of the fund's issuance series the investor adhered to and the signature type must be sent and, depending on the signature, the content needed for validation. See the example below.

As output, an investor_adhesion_key is delivered. The investor_adhesion_key is used to identify the investor adhesion. The adhesion is created already in the active status.

Request

ENDPOINT

/investor_adhesion/investor/INVESTOR_KEY/signed_investor_adhesion

METHOD

POST

STATUS

201

Request body

Request Body

{
  "issuance_serie_key": "UUID",
  "signature_method": "opt_in",
  "opt_in_hash" : "OPT_IN_HASH"
}

Field	Type	Description	Characters	Required
issuance_serie_key	string	Key of the issuance series the investor adhered to	36	Yes
signature_method	string	Signature method used: opt_in or external	up to 100	Yes
opt_in_hash	string	Opt-in hash. Required when signature_method is opt_in	up to 500	No
document_b64	string	Signed term encoded in base64. Required when signature_method is external	-	No
signer_group_key	string	Key of the investor's signer group. If omitted, the investor's default group is used	36	No

Attention

During the integration process, a means of authenticating the submitted hash will be required.

Response

Response Body

{
    "investor_adhesion_key": "UUID"
}

Errors

Status	Code	When it happens
400	IAD000027	The investor's classification does not allow adhering to the series
400	IAD000037	signature_method is opt_in and opt_in_hash was not sent
400	IAD000038	signature_method is external and document_b64 was not sent
400	IAD000039	There is already an adhesion of the investor for this issuance series
400	IAD000051	The investor has no signer group (or the signer_group_key does not exist)
400	IAD000054	The investor is non-operational
400	QIT000011	The integration is not the investor's distributor
404	IAD000012	Investor not found
404	IAD000018	Issuance series not found

Authentication, permission and host errors: see API Errors.