Cashlink Connect
About Cashlink ConnectCashlink Studio DemoMake a test investment
  • Welcome!
  • Cashlink Connect Distribution Hub
  • Cashlink Connect Core
  • ⚙️Distributor API
    • Introduction
    • Getting started
    • Overview
    • Concepts
      • Products
      • Investors
      • Investments
      • Transfers
      • Redemption
    • Example Guide
    • Full Distributor API Reference
  • ⚙️Issuer API
    • Introduction
    • Getting started
    • Overview
    • Concepts
      • Distribution platforms
      • Issuers
      • Products
      • Listings
      • Investments
    • Full Issuer API Reference
  • 🖥️ISSUER CASHLINK STUDIO
    • Issuer creation
  • Product creation
  • 📑Registry Smart Contracts
    • Introduction
    • Getting started
    • Token Interface
  • 💡More information
    • Supported environments
    • Publication of the issuance | Bundesanzeiger
    • BaFin | crypto securities communication
Powered by GitBook
On this page
  • Retrieving investments
  • Retrieving investment details
  • Status field codes

Was this helpful?

  1. Issuer API
  2. Concepts

Investments

PreviousListingsNextIssuer creation

Last updated 3 months ago

Was this helpful?

Each investment represents a contract between the issuer of a product and the investor.

Investments can only be created by distribution platforms via the .

Retrieving investments

You have access to all investments create by all distribution platforms via the distributor API your product is listed.

You can use the /investments endpoint together with your product_id to receive all investment_ids for such a product.

Retrieving investment details

With an investment_id you can receive all necessary information of an investment by calling /investments/{id}. This is the list of data you are able to access:

  • Campaign_id

  • status

  • Units

  • Disagio

  • Accured_interest

  • Investment_amount

  • Payment_total

  • Remaining_amount

  • signed_at

  • accepted_at

  • paid_at

  • delivered_at

  • cancellation_date

  • cancellation_reason

  • payment_details

  • bank_account

  • communcation

  • natural_person

  • legal_person

  • securities_deposit_account

  • tax_information

  • exemption_order_amount

Status field codes

The status field of an investment may have one of the following values:

Status

Description

KYC_PENDING

The investment is signed but the identification process for the investor is still pending.

REVIEW_PENDING

The external review process is still pending.

WAITING_FOR_ACCEPTANCE

The investment is ready to be accepted by the issuer.

ACCEPTED

The investment has been accepted by the issuer.

PAID

The investment amount has been marked as paid.

DELIVERED

The digital securities have been credited to the recipient's wallet. This is the final state of the process.

KYC_INSUFFICIENT

The KYC/AML check could not be completed successfully due to missing or inconsistent data.

ABORTION

The order has been canceled by the investor.

REJECTION

Order execution has been rejected by the issuer.

CANCELLATION

The contract has been canceled by the investor during the cancellation period.

PAYMENT_MISSING

The order has been canceled because the payment has not yet arrived on time.

⚙️
Distributor API