Skip to content

Overview

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.

Authentication

You can obtain a LinkCy Authorization Key by contacting our commercial team here.

Download OpenAPI description
Languages
Servers
Generated server url
https://api.sandbox.linkcy.cloud/
Operations
Operations
Operations
Operations
Operations

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
Operations
Operations
Operations

Delete a corporate-related entity (person or corporate)

Request

Delete a corporate-related physical person or corporate whose KYB status is neither VALIDATED nor PENDING_VERIFICATION.

Security
Linkcy-Auth
Path
corporateRelatedIdstring(uuid)required
No request payload

Responses

OK

Response
No content

Update a corporate-related entity (person or corporate)

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
Path
corporateRelatedIdstring(uuid)required
Bodyapplication/jsonrequired
Any of:

The information to update a corporate related.

externalIdstring[ 0 .. 511 ] characters

A unique identifier that you can use to link this corporate related to a user in your system.

isDirectorboolean

Indicates if this entity is a director of the corporate.

directorAppointmentDatestring(date)

If director, the date on which he was appointed.

firstNamestring[ 0 .. 255 ] characters
middleNamestring[ 0 .. 255 ] characters
lastNamestring[ 0 .. 255 ] characters
addressobject(WorldwideAddressRequest)
nationalityCodestring
Enum"ABW""AFG""AGO""AIA""ALA""ALB""AND""ARE""ARG""ARM"
emailAddressstring
phoneobject(PhoneRequestDto_Partner)

Update the phone of this corporate related person. Note: if you wish to change the phone of an account owner, please contact us.

isSpecialUboboolean

Indicates whether this person was designated UBO because no shareholder holds the percentage of shares required to become one.

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 }

Responses

OK

Bodyapplication/json
idstring(uuid)required
Response
application/json
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08" }

Get diligence review of a corporate

Request

Security
Linkcy-Auth
Path
corporateIdstring(uuid)required
No request payload

Responses

OK

Bodyapplication/json
urlstringrequired
ttlstringrequired
Example: "PT8H6M12.345S"
Response
application/json
{ "url": "string", "ttl": "PT8H6M12.345S" }
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations