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

• is subject to us tax

Please make sure that you're only onboarding investors where the "is_subject_to_us_tax" is set to false. Otherwise creation of wallets will not be possible for these investors

Tax information

On the investor object you can add tax related information which is needed for crypto securities or for the issuer of digital securities:

• tax identification number

• non assessment certificate

• is subject to german tax

Payment information

On the investor object you must add bank account information to provide payouts or for redemption. Such data is:

• 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.

Legal persons can be marked as "custodian banks" if they want to hold securities in cumulative entry. For those investors the restriction of tax information to create a wallet do NOT apply!

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.

Wallets can only be added to investors, if all relevant tax information is set on the Investor

(Does not apply for investors with legal persons marked as "custodian banks")

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 Cashlink or Tangany, depending on your contract. This needs to be setup for your platform and investors need to accept either the Tangany custody terms and conditions or the Cashlink 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.