Skip to content
/
List card profiles

Linkcy Api (1.114.5)

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
sandbox.json
sandbox.yaml
Overview
URL
https://linkcy.io/#contact
Languages
Servers
Generated server url
https://api.sandbox.linkcy.cloud/

Authentication

Operations

Strong Authentication

Operations

Partner

Operations

Webhook

Operations

End-user

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

Corporate

Operations

KYC

Operations

KYB

Operations

Documents

Operations

Ledger

Operations

Card

Operations

Activate a card

Request

When activating a card for the first time, you must retrieve its truncated PAN from the end-user. In Sandbox, you can retrieve the PAN here.

Security
Linkcy-Auth
Path
cardIdstringrequired

The card id

Bodyapplication/jsonrequired
truncatedPanstring^[0-9]{4}$

Last 4 digits of the card. This value is only available when the card has been received by the end-user.

Example: "1111"
application/json
{
  "truncatedPan": "1111"
}

Responses

Card is being activated

Response
No content

List card profiles

Request

Fetch all card profiles based on parameters.

Security
Linkcy-Auth
Query
sortAttributestring
Value"NAME"
userTypesArray of strings
Items Enum"CORPORATE""CONSUMER"
ledgerTypesArray of strings
Items Enum"EUR_BELGIUM""EUR_FRANCE""EUR_ESTONIA""EUR_LITHUANIA""USD_USA""GBP_GREAT_BRITAIN""EUR_BG"
cardTypesArray of strings
Items Enum"PHYSICAL""VIRTUAL"
activeboolean
pageSizeinteger(int32)<= 100

The size of the page to be returned.

pageinteger(int32)[ 0 .. 500 ]

The page number.

sortDirectionstring
Enum"ASC""DESC"
No request payload

Responses

OK

Bodyapplication/json
contentArray of objects(CardProfileListElementDto)required
content[].​idstring(uuid)required
content[].​namestringrequired
content[].​schemestringrequired
Enum"MASTERCARD""VISA"
content[].​ledgerTypestringrequired
Enum"EUR_BELGIUM""EUR_FRANCE""EUR_ESTONIA""EUR_LITHUANIA""USD_USA""GBP_GREAT_BRITAIN""EUR_BG"
content[].​cardTypestringrequired
Enum"PHYSICAL""VIRTUAL"
content[].​userTypestringrequired
Enum"CORPORATE""CONSUMER"
content[].​activebooleanrequired
content[].​programobject(Program)required
content[].​program.​idstring(uuid)required
content[].​designobject(Design)required
content[].​design.​idstring(uuid)required
content[].​rulesArray of objects(Card Rule)required
content[].​rules[].​typestringrequired
Enum"DAILY_MAX_SPEND""MONTHLY_MAX_SPEND""WEEKLY_MAX_SPEND""DISABLE_CONTACTLESS""DISABLE_ONLINE""DISABLE_RECURRING""MCC_WHITELIST""MCC_BLACKLIST""MERCHANT_WHITELIST""MERCHANT_BLACKLIST"
content[].​rules[].​namestring
content[].​rules[].​valueinteger(int64)
content[].​rules[].​targetsArray of strings
totalElementsinteger(int64)required
Example: 1
pageinteger(int32)required

The page number.

pageSizeinteger(int32)required

The requested page size.

Response
application/json
{
  "content": [
    { … }
  ],
  "totalElements": 1,
  "page": 0,
  "pageSize": 0
}

Create a card profile

Request

Create a card profile based on a card design.

Security
Linkcy-Auth
Bodyapplication/jsonrequired
namestringrequired
cardDesignIdstring(uuid)required

The card design identifier on which the new card profile will be based.

activeboolean

When active, end-users are able to see this profile and create card with it.

When disabled, it can not be used to create new cards anymore.

application/json
{
  "name": "string",
  "cardDesignId": "21f1b6eb-5662-41f7-952d-3d240b7c3aed",
  "active": true
}

Responses

Created

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

Acquiring

Operations

Beneficiary

Operations

Transaction

Operations

Direct Debit Mandate

Operations

Wallet

Operations

Crypto Beneficiary

Operations

Crypto Transaction

Operations

Additional

Operations

Sandbox

Operations

Web Pages

Operations