Links

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
In addition, the following data can be optionally stored for the investor if needed:
  • bank account
  • securities deposit account
  • tax information
Depending on the product's configuration, investors need to have this data set.

Account setup document

Via the investor endpoint, you're required to deliver the date and time on which the investor agreed to an account setup document. The document is signed and marked with the investor data after the KYC/AML process for that investor is completed. After that, you are able to retrieve the signed document via the signed documents endpoint for that investor.
This is only required if you use the Investment Platform API offering. If you use the Registry-as-a-Service API product, adding this to the investor is not required.
You can also create an investor that is a legal person. In this case, you need to provide additional information. For the account setup to be successful you'll need to add company data such as the company name and documents proofing the identity of the company.

Benefiting persons

If you have created a legal person as an investor, you also need to provide the data of the benefiting persons of the legal person 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 a single 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.

Identifications

Investors need valid identification data that is the result of a video identification process. In order to get this data, you need to follow this process:
  1. 1.
    Via the identification endpoints, create a new identification with an empty JSON request. The API will return a URL to the identity provider and the ID of the identification process.
  2. 2.
    Redirect the investor to the provided URL. The investor can use that URL to finish the video identification process.
  3. 3.
    You can use the identification endpoints and the identification ID to query the current status of the identification.
  4. 4.
    After the identification is finished, the result data is available via the same API call.
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 stay in the KYC_PENDING status.

Wallets

In order to receive 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, for the settlement process to finish a wallet needs to be set.
There are two different types of wallets:
  • Generic wallets are created via the /eth-generic/ endpoint by providing an address. A wallet 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 don't 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.
Please note that in order to create a wallet, the investor must have completed the KYC/AML process.