Card Transactions - 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 (splitted or credits 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`	Unknow 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`	Unknow 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,...
`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 swipe in the terminal
`E_COMMERCE`	Regular e-commerce transaction
`MAGNETIC_STRIPE_CONTACTLESS`	Contactless transaction, using Magstripe data
`QR_CODE`	QR Code reader
`EMV_CONTACTLESS`	Contacless 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 :

Copy

Copied

{
"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 :

Copy

Copied

{
"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)