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

Was this helpful?

  1. Distributor API
  2. Concepts

Redemption

PreviousTransfersNextExample Guide

Last updated 3 months ago

Was this helpful?

This redemption process is only available for .

Investors with active investments are granted certain rights (dividends or interest payments for example). When the contract has ended or the contract’s nominal amounts needs to be reduced because of some legal construct in the contract, the balance for that investor needs to be reduced. Such a transaction is called "redemption" and is controlled via the redemption endpoints.

You can create a redemption by providing the following data:

  • Redemption amount

  • Investor ID

  • Product ID

  • Wallet ID

After the redemption is created, the balance for that investor and the product is reduced by the amount entered via API - the source investment is calculated following the FIFO (first-in-first-out) ordering.

The redemption can only be triggered if the amount on the provided wallet address is sufficient for the redemption. Otherwise an error is returned.

The response contains a status field with the following codes:

  • processing: The task is created and is currently being executed

  • failed: The task could not be completed

  • success: The task was completed successfully

  • unknown: The task needs manual investigation to determine if the transaction has actually succeeded

The redemption triggers a burn transaction on-ledger reducing the balance on the wallet. The remaining amount is the new notional amount of the contract and is used to calculate payouts, for example. You can query the original amount as well as the remaining amount as part of the investment endpoints. Note that the amount will update as soon as the on-ledger transaction succeeded.

⚙️
digital securities