Products

A product represents a digital security or a crypto security issued by an entity on a distributed ledger network.

Products are referenced in the API using the product ID. Using the products endpoint you can retrieve all products that you have created.

Digital securities vs crypto securities

Digital securities or security tokens are securities that are not issued under the eWpG regulation in Germany.

Crypto securities are issued under the eWpG law where a crypto security registrar is taking care of KYC, AML, issuer identifications and is running an on chain registrar that holds the relation between investors and investments. Cashlink is operating as a crypto security registrar.

Creating a product

As of now the issuer API can only be used with digital securities. If you want to issue crypto securities under the eWpG law, please contact [e-mail]

To create a product ensure, that you have done these steps before hand

• Create an issuer and have the id available

• uploaded the issuance document and have the id available

The following data is needed to create a product

Field	Description
Name	Name of the product. This will be displayed in Cashlink Frontends and in the smart contract
Product type	The legal type of the product. These types are available: DIGITAL_COMPANY_SHARE BOND SUBORDINATED_LOAN PARTICIPATION_PAPER PARTICIPATION_RIGHT, AIF DEBT_SECURITY CONVERTIBLE_BOND FUND_SHARE
Ewpg	This must always be set to false
ISIN	This is optional
Nominal amount	The price of the token per unit as stated in the issuance document
Maximal issuable amount	The maximum number of tokens units for sale. Must be the same as in the issuance document
Step size	The size of which the investor can invest
Agio	If an agio applies, it can be defined here
Payment deadline	How long do investors have to meet their payment obligations (in days)?
DLT network	The network where the smart contract should be deployed to. These networks are available: ETH-MAINNET ETH-TEST POLYGON-MAINNET POLYGON-AMOY
Code	To identify the asset. Must be smaller than 12 characters.
Calculation factor	The relation between one token and one asset. Will be 1 in most cases.
backup wallet	Backup wallet address on the DLT network. If you do not have a backup wallet, you can reach out to Cashlink via Client Service Desk to request one.
lock in time	Date until the tokens cannot be transfered
issuance document id	id of the issuance document
issuer id	id of the issuer

With the product id, you can fetch the status of the product. The product can be in these status:

Status	Description
Processing	You have submitted the product and the deployment process of the smart contract is running
Waiting	You have not submitted all mandatory data so far
Succeeded	The deployment of the smart contract is done and you can retrieve the smart contract address
Failed	The deployment has failed. Reach out to Cashlink Service Desk
Queued	The deployment on the DLT network is queued due to too many requests.
Unknown	The process is in an unknown state. Reach out to Cashlink Service Desk

Campaigns

Products can have one or more campaigns used on the primary market for distribution. The total available allocation of a product can be split into any number of campaigns. The total allocation spread across all campaigns must not exceed the total allocation of the product.

Campaigns are referenced in the API using the campaign ID. You can use the campaigns endpoints to retrieve all campaigns for a product.

Creating a campaign

To create a campaign ensure, that you have done these steps before hand:

• Create a product and have the id available

• The product is listed for a distribution platform and you have the distribution platofrm id available

You can only create one campaign for one distribution platform per request

The following data is needed to create a campaign

Field	Description
Distribution platform id	Id of the distribution platform where the product is listed on
Name	Name of the campaign
Allocation	Number of token that are allocated in this campaign
Minimum number of tokens	Minimum number of tokens that must be purchased in one investment
Maximum number of tokens	Maximum number of tokens that can be purchased in one investment
Legal persons allowed	If set to true, legal persons are allowed to invest
Natural persons allowed	If set to false, legal persons are allowed to invest
Country	Residence country of the investor(s)
Rule type	Two rule types can be set: MINIMUM INVESTMENT AMOUNT: Only allows investments starting at a specific investment amount PUBLIC OFFERING: No restrictions apply to the creation of new investments.
is campaign active	If set to true, distributors can create investements for the campaign. If set to false no new investments can be made

After creating a campaign the only value that can be changed is the is campaign active field. If any other data of a campaign needs to be changed after initial creation, a new campaign must be created and the old one muste be set to inactive.