Security ownership transfer using API

This section provides a detailed guide for clients who prefer a more hands-on approach to investment management, allowing for deeper integration with existing systems and greater control over the investment/trading workflow. This approach involves using the /omni-omni/v1/transfers API endpoint to submit and manage investment transactions directly.

​

Use Case

This API integration approach is ideal for clients who have their own investor-facing platform and want to leverage ecrop primarily for token management, regulatory compliance (registering the transfer of securities), and blockchain interaction. By handling the investment workflow within their own systems, clients can maintain greater control over the user experience, branding, and data management, while still benefiting from ecrop’s core functionalities.

​

Prerequisites

Before implementing this approach, ensure you fulfill the following prerequisites:

• KYC/AML Compliance: You are responsible for performing KYC/AML checks on your investors. Refer to [End-Client Onboarding and KYC] for details on KYC/AML requirements and options for integration with ecrop.
• MiFID II Compliance (if applicable): If your offering targets individual investors within the EU, you are responsible for implementing the necessary MiFID II investor protection measures, including the collection of investment experience and knowledge data.
• Payment Processing: You are responsible for handling payment processing through your own payment provider. You will need to provide ecrop with proof of payment for each investment.
• Proof of Action (PoA): The register needs proof of action for ownership transfers, that means a request that is signed by the private key of the sender and receiver parties. We offer two ways of accomplishing that:
  1. PoA Implementation: You must implement ecrop’s Proof of Action (PoA) mechanism within your system to authenticate and authorize investment transactions. Refer to the PoA Documentation for detailed instructions and examples.
  2. Usage of ecrops OmniPersona: We offer a PSD2-like approach that is covered by an app called OmniPersona. This app handles all the intricacies of request signing and security for you.