The information to update a corporate related.
- Get diligence review of a corporate
Create a share
Declare a corporate-related entity (person or corporate)
Ask a KYB verification
Get share's information
Delete a share
Update a share
Get corporate-related entity's information
Delete a corporate-related entity (person or corporate)
Update a corporate-related entity (person or corporate)
Get corporate-related entities list
Get diligence review of a...
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
Request
You can patch a corporate related to update some information whether it's a corporate or a person. Depending on the information patched, you will have to perform another action:
- As a person:
First name -> no actions to perform
Last name -> no actions to perform
Phone -> you will need to use Endpoint POST Send consumer verification code & validate consumer phone
Address : we will use our tools to check if the address is valid or not, we recommend you to ask your consumer to confirm the address once the modification is done. Address is very important to send cards. Once the card is activated, the address status will go from valid to verified.
Email address -> The "emailAddressVerified" status will switch to "false" you will need to use Endpoint POST Send a verification email to the consumer to verify the email address.
- As a corporate:
Registered name -> no actions to perform
Incorporation code -> no actions to perform
Incorporation country -> no actions to perform
Security
Linkcy-Auth
Any of:
A unique identifier that you can use to link this corporate related to a user in your system.
Update the phone of this corporate related person. Note: if you wish to change the phone of an account owner, please contact us.
- Generated server urlhttps://api.sandbox.linkcy.cloud/api/partner/corporates/related/{corporateRelatedId}
- Payload
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
application/json
{ "externalId": "string", "isDirector": true, "directorAppointmentDate": "2019-08-24", "firstName": "string", "middleName": "string", "lastName": "string", "address": { "isoCountryCode": "ABW", "city": "string", "postalCode": "string", "street": "string", "number": "string", "refinement": "string", "stateOrProvince": "string", "bypassVerification": true }, "nationalityCode": "ABW", "emailAddress": "string", "phone": { "countryCode": "33", "number": "string" }, "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.
- Generated server urlhttps://api.sandbox.linkcy.cloud/api/partner/documents/diligence-review/{corporateId}
- Payload
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
No request payloadResponse
application/json
{ "url": "string", "ttl": "PT8H6M12.345S" }
If you notice an error or find something unclear, we’d greatly appreciate your feedback to help us improve.
- Generated server urlhttps://api.sandbox.linkcy.cloud/api/partner/corporates/related
- Payload
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
No request payloadOK
contentArray of CorporateRelatedPhysicalPersonListElement_Partner (object) or CorporateRelatedCorporateListElement_Partner (object)(CorporateRelatedListElementDto_Partner)required
Any of:
Address used on the bank statements of your users.
Enum"NOT_STARTED""CREATED""PROCESSING""ABORTED""PENDING_REVIEW""VALIDATED""DECLINED"
Indicates if this is the person who manage the corporate account.
Indicates if this entity is a director of the corporate.
If director, the date on which he was appointed.
Indicates if this person owns more than 25% of the corporate end-user shares (10% if the corporate required extended UBOs) or isSpecialUbo.
Response
application/json
{ "content": [ { … } ], "totalElements": 1, "page": 0, "pageSize": 0 }