Your account must be white-listed to use this feature. Please talk to your contact person at Cashlink if you want to use this feature.
The API allows to start a web-based subscription process for investors. After creation, the API returns an URL that investors can use to finish the investment.
Step 1: Import data of your users
First, collect data about the investor in your application or use already entered data. Then, create an investor including identification data via the API and store the created investor id with your user account.
We don't use any uniqueness constraints on email addresses. The email address from the API call is only used to pre-fill an input field on the welcome screen. Make sure that you only create users if they don't already have an account by storing the Cashlink investor ID with your user accounts.
After registering, show the user a detailed view with information about the investment opportunity including an "Invest now" button. As soon as the investor clicks on that button, create an investment for this investor and campaign.
Starting a web-based subscription is done by omitting the signed date in the create investment request.
If you omit the signed date in the request and the feature is not available for your account you will receive an error response.
The API will then return a field named start_url. Redirect the user to this URL so that the investor can finish the investment process online.
Assuming you have already created an investor with the data your user has entered you can retrieve the start_url by calling the investment API: