Create a new corporate-related share.
Linkcy Api (1.114.5)
This is the partner API from linkcy. Here you can find our API documentation.
LinkCy API allows you to create fully embedded banking products for your own company or consumers. This API is backed by all mandatory requirements by financial authorities. To process, information provided into the API must be accurate.
You can obtain a LinkCy Authorization Key by contacting our commercial team here.
Download OpenAPI description
Overview
Languages
Servers
Generated server url
https://api.sandbox.linkcy.cloud/
Consumer
The consumer represents the individual partner client. It must have a valid phone number and be formally identified with a KYC procedure before carrying out any operation.
Operations
Bodyapplication/jsonrequired
Any of:
Must be filled in if the owner is UBO (shareholder with 25%+ shares or 10%+ shares if the corporate must provide extended UBOs).
- Generated server urlhttps://api.sandbox.linkcy.cloud/api/partner/shares
- Payload
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
application/json
{ "corporateRelatedId": "f2c36984-cb53-436d-84e1-092eab51bcc5", "percentage": 100 }
Response
application/json
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08" }
If you notice an error or find something unclear, we’d greatly appreciate your feedback to help us improve.
Request
Add a person or corporate-related to the current corporate who may be the account owner, a director or a UBO (shareholder with 25%+ shares (10% if the corporate required extended UBOs)).
Adding all the directors and UBOs of the corporate is a mandatory step to complete the KYB and access all banking features.
After adding a corporate-related person, you must provide them with a KYC link.
Security
Linkcy-Auth
- Generated server urlhttps://api.sandbox.linkcy.cloud/api/partner/corporates/{corporateId}/related
- Payload
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
application/json
{ "isDirector": true, "directorAppointmentDate": "2019-08-24", "sharesInfo": [ { … } ], "info": { "firstName": "string", "lastName": "string", "address": { … }, "nationalityCode": "ABW", "emailAddress": "string", "phone": { … }, "isSpecialUbo": true } }
Response
application/json
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08" }
If you notice an error or find something unclear, we’d greatly appreciate your feedback to help us improve.
Request
This endpoint allows you to ask a KYB verification for a Corporate End-User.
In order to use this endpoint, all its UBOs and directors must have been declared and have completed a validated KYC application.
After using this endpoint, a Linkcy compliance officer will verify the information provided and update the KYB status to one of the following values:
VALIDATED -> this corporate is now authorized to access Linkcy's banking features.
NEED_ADDITIONAL_INFORMATION -> Additional information is needed to validate this corporate. The description of the requested information will be displayed in the kybStatusReason field.
DECLINED -> this corporate violates compliance rules and is not authorized to use Linkcy's banking features.
Security
Linkcy-Auth
- Generated server urlhttps://api.sandbox.linkcy.cloud/api/partner/corporates/{corporateId}/kyb/verification/ask
- Payload
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
No request payload