Investors

Investors are natural or legal persons that buy and hold units of a digital security.

Creating an investor

Investors can be created via the investor endpoints. The information stored with an investor includes the following mandatory data:

• personal data

• residence address

Tax information

On the investor object you can add tax related information that might be needed by the issuer:

• tax identification number

• non assessment certificate

Payment information

On the investor object you cann add bank account information if the issuer needs such data to provide payouts or for redemption. Such data can be:

• BIC

• IBAN

• currency

Creating legal persons

You can also create an investor that is a legal person. In this case, additional information must be provided. For the account setup to succeed you need to provide company data such as the company name and documents proofing the identity of the company.

Benefiting persons

If you have created an investor that is a legal person, information about its benefiting persons must be provided via the benefiting persons endpoint.

If you have created an investment for that legal person, the status of the investment will remain in the KYC_PENDING step until you provide the data of at least one benefiting person.

Please make sure that you're only onboarding investors where the benefiting persons are not "politically exposed persons" (PEP). During the KYC/AML process a background check is performed and investments of PEPs may be rejected.

If the benefiting persons change, please add the new persons via a new POST request. You do not need to delete existing benefiting persons if they're not a benefiting person any more.

Identifications

Create new identifications

Investors need valid identification data from a video identification process. In order to get this data, you need to follow this process:

1. Via the identification endpoints, create a new identification with an empty JSON request. The API will return a URL of the identity provider and the ID of the identification process.

2. Redirect the investor to the provided URL. The investor can use the URL to complete the video identification process.

3. You can use the identification endpoints and the identification ID to query the current status of the identification.

4. After the identification is completed, the final data can be retrieved via the same API call.

Import existing identifications

If you have already existing and valid identifications of the investor you can also provide all attributes via the API directly. Next to the person_id you need to provide:

1. The identity provider you used. So far we support IDNOW, Lionware and PostIdent. You have to add the legitimation protocol

2. You have to add the document type that was used (id card, passport), the issuer of the document as well as the document ID

3. For checking if the identification is valid, you also need to at the valid from and valid to date of the document used for identification

You don't need to add the identification data during the creation of the investor or even before an investment is created. However, for investments to succeed, a valid identification must be set. Otherwise investments will remain in the KYC_PENDING status.

Wallets

In order to receive crypto securities or digital securities during the settlement process, investors need wallets. Wallets are created for investors using the wallet endpoints.

You can create an investment for an investor without a wallet present. However, to credit the purchased crypto securities or digital securities, a wallet must be set.

There are two different types of wallets:

• Generic wallets are created via the /eth-generic/ endpoint by providing an account address. An account address is always connected to a single investor identity. It cannot be shared between investors. An investor can have more than one generic wallet.

• Managed wallets are created via the /eth-managed/ endpoint. You do not need to provide an address for managed wallets because the address is created when you trigger the creation via the API. Investors can only have a single managed wallet. Managed wallets are provided by Tangany. This needs to be setup for your platform and investors need to accept the Tangany custody terms and conditions before you create a wallet via the API.

Please note that in order to create a wallet, the investor must have completed the KYC/AML process.