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

Request

Create a partner user account.

Security
Linkcy-Auth
Bodyapplication/jsonrequired
Partner user account (object)(AccountCreateRequestDto)
application/json
{ "email": "string", "roles": [ "ACCOUNT_CREATE" ] }

Responses

Created

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

Request

Get your configuration information as partner.

Security
Linkcy-Auth
No request payload

Responses

OK

Bodyapplication/json
namestringrequired
displayNamestring

Name display on documents.

logoUrlstring

Url that provides the logo.

addressobject(AddressResponseDto_Partner)

Address used on the bank statements of your users.

consumerOtpMessagestring

Message displayed when requesting a OTP message.

corporateOtpMessagestring

Message displayed when requesting a OTP message.

emailPropertiesobject(EmailProperties_Partner)
contactInformationobject(ContactInformation_Partner)required
contactInformation.​adminEmailstring
contactInformation.​billingEmailstring
contactInformation.​commercialEmailstring
contactInformation.​techEmailstring
contactInformation.​complianceEmailstring
limitsobject(PartnerLimitsResponseDto_Partner)required

Configuration of limits.

limits.​ledgerobject(Partner Default Ledger Limits)

Configuration of the default ledger limits for this partner.

limits.​sctInstobject(Partner Default SEPA Credit Transfer Instant Limits)

Configuration of the default transaction limit for SEPA Instant Credit Transfer (SCT Inst) for this partner.

limits.​limitedStatusobject(Partner Default limited status Limits)

Default transaction limit configuration for end-users with limited status for this partner

creationDatestring(date-time)required
updateDatestring(date-time)required
Response
application/json
{ "name": "string", "displayName": "string", "logoUrl": "string", "address": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "isoCountryCode": "ABW", "city": "string", "postalCode": "string", "street": "string", "number": "string", "refinement": "string", "stateOrProvince": "string", "status": "INVALID" }, "consumerOtpMessage": "string", "corporateOtpMessage": "string", "emailProperties": { "senderEmailAddress": "string", "senderEmailName": "string" }, "contactInformation": { "adminEmail": "string", "billingEmail": "string", "commercialEmail": "string", "techEmail": "string", "complianceEmail": "string" }, "limits": { "ledger": {}, "sctInst": {}, "limitedStatus": {} }, "creationDate": "2019-08-24T14:15:22Z", "updateDate": "2019-08-24T14:15:22Z" }

Request

Update your configuration information as Partner.

Security
Linkcy-Auth
Bodyapplication/jsonrequired
addressobject(EuropeanAddressRequest)

Address that will be used on the bank statements of your users.

consumerOtpMessagestring

Message that will be displayed when requesting a OTP message. You must include the following place holder: "$otp" where you want to display the OTP secret.

If not set, the default message is: "Your {partnerName} secret to change your password is: {secret} If you are not at the origin of this message, you can ignore it."

corporateOtpMessagestring

Message that will be displayed when requesting a OTP message. You must include the following place holder: "$otp" where you want to display the OTP secret.

If not set, the default message is: "Your {partnerName} secret to change your password is: {secret} If you are not at the origin of this message, you can ignore it."

displayNamestring

Name display on documents.

logoUrlstring

Url that provides the logo.

contactInformationobject(ContactInformation_Partner)
application/json
{ "address": { "isoCountryCode": "AUT", "city": "string", "postalCode": "string", "street": "string", "number": "string", "refinement": "string", "stateOrProvince": "string", "bypassVerification": true }, "consumerOtpMessage": "string", "corporateOtpMessage": "string", "displayName": "string", "logoUrl": "string", "contactInformation": { "adminEmail": "string", "billingEmail": "string", "commercialEmail": "string", "techEmail": "string", "complianceEmail": "string" } }

Responses

OK

Bodyapplication/json
idstring(uuid)required
updateDatestring(date-time)required
Response
application/json
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "updateDate": "2019-08-24T14:15:22Z" }
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
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations