Details

Some fields of the Card transaction can help you to understand the "context" : How was used the card, was the cardholder present, ...

Cardholder Presence

Field holderPresent indicates whether the cardholder is present at the point of service and explains the condition if the cardholder is not present.

holderPresent	Description
PRESENT	Cardholder is present at the Point of Sale.
NOT_PRESENT_STANDING_AUTH_OR_RECURRING_TRANSACTION	Cardholder is not present, recurring transaction.
NOT_PRESENT_INSTALLMENT_TRANSACTION	Cardholder is not present, installment transaction (split or credit payments).
NOT_PRESENT_E_COMMERCE	Cardholder is not present, e-commerce transaction.
NOT_PRESENT_MAIL_ORDER	Cardholder is not present, mail order transaction.
NOT_PRESENT_TELEPHONE_ORDER	Cardholder is not present, phone order transaction.
NOT_PRESENT_UNSPECIFIED	Cardholder is not present, condition not specified.
UNKNOWN or UNRECOGNISED	Unknown value.

Card Presence

Field cardPresent indicates if the card is present at the point of service.

cardPresent	Description
PRESENT	Card is present at the Point of Sale.
NOT_PRESENT	Card is not present.
UNKNOWN or UNRECOGNISED	Unknown value.

Terminal Attendance

Field terminalAttendance indicates if the card acceptor is attending the terminal.

terminalAttendance	Description
ATTENDED	Terminal is attended by the merchant/acceptor.
UNATTENDED	Unattended terminal: cardholder self-activated terminal, home PC, mobile phone, etc.
NO_TERMINAL_USED	No terminal used.
UNKNOWN or UNRECOGNISED	Unknown value.

Input Method

Card Transaction have an inputMethod field.

This indicates the method used for PAN entry to initiate a transaction at the point of sale.

inputMethod	Description
EMV_CONTACT	Contact transaction - Chip was inserted in the terminal.
UNSPECIFIED	Information was not provided by the merchant.
E_COMMERCE_WITH_EMV	Ecommerce transaction with a contact chip reader.
BARCODE	Barcode reader.
KEY_ENTERED_BY_ACQUIRER	Manually entered by the Acquirer.
MAGNETIC_STRIPE	Magstripe transaction - Card magnetic stripe was swiped in the terminal.
E_COMMERCE	Regular e-commerce transaction.
MAGNETIC_STRIPE_CONTACTLESS	Contactless transaction, using Magstripe data.
QR_CODE	QR Code reader.
EMV_CONTACTLESS	Contactless transaction - Card was at proximity of the terminal.
MANUAL	Manual entry for e-commerce and card-not-present transactions.
OCR	Optical Character Recognition - Card credentials were recognized by a camera.
UNRECOGNISED	Value not known.
KEY_ENTERED	Manual entry for e-commerce and card-not-present transactions.
ACCOUNT_DATA_ON_FILE	Card credentials were already stored by the Merchant, Acquirer, PSP, or Wallet Provider.
MICR_READER	Magnetic Ink Character Recognition - Not used for LinkCy cards.
UNKNOWN	Value not known.

Device From Factor

Field deviceFormFactor indicates the type of device used at the terminal.

For now LinkCy's card only support the CARD form factor.

deviceFormFactor
TABLET
JEWELRY
STICKER
MOBILE_PHONE
MOBILE_PHONE_OR_TABLET
WRISTBAND
MINI_CARD
CLOTHING_OR_APPAREL
MOBILE_TAG_CASE_OR_SLEEVE
FASHION_ACCESSORY
DOMESTIC_APPLICATION
NON_CARD
CARD
FOB_OR_KEY_FOB
WATCH
VEHICLE
PERSONAL_COMPUTER_OR_LAPTOP
MEDIA_OR_GAMING_DEVICE
UNKNOWN or UNRECOGNISED

Example of card authorization payload :

{
"id": "9585a171-faa6-4341-9297-dd8d04ab60d3",
"type": "CARD_AUTHORIZATION",
"paymentType": "PURCHASE",
"status": "APPROVED",
"creationDate": "2022-08-08T16:23:08.665141",
"amount": 32.73,
"currency": "EUR",
"information": {
    "clearingDate": "2022-08-10T07:32:55.241555",
    "originalAmount": 32.73,
    "originalCurrency": "EUR",
    "conversionRate": "1"
    },
"sender": {
    "enduserId": "9ab4baa7-d151-4ce7-91cf-6afdd626c3c6",
    "enduserName": "john doe",
    "ledgerId": "c4cb8a18-af6b-426a-93c8-f4b6ab3a2d51",
    "ledgerFriendlyName": "my ledger",
    "cardId": "5d1481b9-532d-41d4-b64d-a6803f2e9cd3",
    "cardFriendlyName": "New Card"
    },
"merchant": {
    "id": "*80750226500018",
    "name": "MARCHE DE BEA",
    "city": "PUILBOREAU",
    "country": "FRA",
    "categoryCode": "1740",
    "description": "Insulation – Contractors Masonry Stonework Contractors Plastering Contractors Stonework and Masonry Contractors Tile Settings Contractors"
    },
"cardDetails": {
    "truncatedPan": "7535",
    "token": "194344345",
    "terminalAttendance": "ATTENDED",
    "holderPresent": "PRESENT",
    "cardPresent": "PRESENT",
    "deviceFormFactor": "CARD",
    "inputMethod": "EMV_CONTACTLESS"
    },
"direction": "DEBIT"
}

Here is the associated card clearing, once received :

{
"id": "9c7348fd-06b9-428a-86cb-92a632f289f7",
"type": "CARD_CLEARING",
"paymentType": "PURCHASE",
"status": "APPROVED",
"creationDate": "2022-08-10T07:32:55.241555",
"amount": 32.73,
"currency": "EUR",
"information": {
    "originalAmount": 32.73,
    "originalCurrency": "EUR",
    "conversionRate": "1",
    "originalTransactionId": "9585a171-faa6-4341-9297-dd8d04ab60d3" // Id of the initial card authorization
    },
"sender": {
    "enduserId": "9ab4baa7-d151-4ce7-91cf-6afdd626c3c6",
    "enduserName": "john doe",
    "ledgerId": "c4cb8a18-af6b-426a-93c8-f4b6ab3a2d51",
    "ledgerFriendlyName": "my ledger",
    "cardId": "5d1481b9-532d-41d4-b64d-a6803f2e9cd3",
    "cardFriendlyName": "New Card"
    },
"merchant": {
    "id": "080750226500018",
    "name": "MARCHE DE BEAULIEU",
    "city": "PUILBOREAU",
    "country": "FRA",
    "categoryCode": "1740",
    "description": "Insulation – Contractors Masonry Stonework Contractors Plastering Contractors Stonework and Masonry Contractors Tile Settings Contractors"
    },
"cardDetails": {
    "truncatedPan": "7535",
    "token": "194344345",
    "terminalAttendance": "ATTENDED",
    "holderPresent": "PRESENT",
    "cardPresent": "PRESENT",
    "deviceFormFactor": "UNKNOWN",
    "inputMethod": "EMV_CONTACTLESS"
    },
"direction": "DEBIT"
}

Once the card clearing is received, card authorization status will change to RELEASED and field clearingTransactionId will be displayed.

Some data could be different between card Authorization and card Clearing, especially merchant details (id, name and city)