Transaction Types

Here are the different transaction types and the associated payload.

For card transactions, direction of transactions are in a specific field in the payload. For others, direction of transactions are deducted from receiver and sender object.

Inter-Ledger

INTER_LEDGER transaction types are money transfers between to Ledgers existing in LinkCy system.For an INTER_LEDGER transaction, paymentType is always MONEY_TRANSFER

Inter-ledger transaction example :

Copy

Copied

{
"id": "329f0206-658e-494f-935b-4cf013810cab",
"type": "INTER_LEDGER",
"paymentType": "MONEY_TRANSFER",
"status": "APPROVED",
"creationDate": "2022-08-01T13:56:46.624667",
"amount": 500,
"currency": "EUR",
"information": {
    "clearingDate": "2022-08-01T13:56:46.624667",
    "originalAmount": 500,
    "originalCurrency": "EUR",
    "conversionRate": "1"
    },
"sender": {
    "enduserId": "3882759a-9e13-4b96-8114-9a4bb017bbe8",
    "enduserName": "mathieu bottausci",
    "ledgerId": "fddf584c-82b5-46ab-921c-0b805b44454c",
    "ledgerFriendlyName" : "My Ledger"
    },
"receiver": {
    "enduserId": "7e696c1b-5693-4934-83d5-55af9acecdac",
    "enduserName": "romaric bouxin",
    "ledgerId": "d51d4bde-7b2a-43ac-94ec-7eab3843ab9d",
    "ledgerFriendlyName" : "My Other Ledger"
    }
},

SEPA Credit Transfer

SEPA_CREDIT_TRANSFER transaction types (SCT) are credit transfer transaction, using the SEPA rails.The paymentType details this transaction :

paymentType	Description
SCT_SEND	Outgoing transaction (sent to a beneficiary), not instant : Credit transfer takes few days
SCT_INSTANT_SEND	Outgoing transaction (sent to a beneficiary), using SEPA instant: Credit transfer is done within 10 seconds
SCT_RECEIVE	Incoming transaction (received from an external account), not instant
SCT_INSTANT_RECEIVE	Incoming transaction (received from an external account), using SEPA instant: Credit transfer is done within 10 seconds

GBP Credit Transfer

GBP_CREDIT_TRANSFER transaction types are credit transfer transaction, using the UK BACS or FasterPayment rails.

Details to come soon

Card Authorization and Card Clearing

Card transactions involve 2 different transaction types as it is done in 2 steps. Here is a summary of both types.
More explanations are available on the dedicated page : Learn More about Card Transactions

CARD_AUTHORIZATION transaction type refers to the Authorization flow : Money is only "reserved, but not debited (or credited) from (to) the Ledger. In case of a debit authorization : reservedAmount and availableAmount balance fields will be impacted.
In case of a credit authorization, no reservation is made, reservedAmount and availableAmount are not impacted and money is credited once the Clearing transaction is received
CARD_CLEARING transaction types refers to the Clearing flow (which follow the Authrozaiton flow). This is the "financial" flow, where money is effectively debited (or credited) from (to) the Ledger, and is not reserved anymore. Thus, all the balance fields are impacted.

The paymentType provides context to these transactions. :

paymentType	Direction	Description
"ACCOUNT_FUNDING"
"ACCOUNT_TRANSFER"
"ACCOUNT_VERIFICATION"	None	A transaction with zero as an amount. used by merchants to verify that card and account are working
"ADJUSTMENT_CREDIT"	Credit	Adjustement of a previous transaction. New credit in addition to the amount that was originally credit
"ADJUSTMENT_DEBIT"	Debit	Adjustement of a previous transaction. New debit in addition to the amount that was originally debited
"CASH_ADVANCE"	Debit	Cash advance borrows a certain amount of money against your credit card’s line of credit, in exchange of Cash
"CHECK_DEPOSIT"	Credit	Deposit of a check, credited to the Card
"DEPOSIT"	Credit	Deposit, credited to the Card
"FEE_COLLECTION"	Debit	Collection of Fees related to the Card
"ORIGINAL_CREDIT"	Credit	Credit on card
"PAYMENT_TRANSACTION"	Credit	A Payment Transaction is a transfer of funds to an Account via the Interchange System. A Payment Transaction is not a credit that reverses a previous purchase Transaction.
"PURCHASE"	Debit	Regular Purchase made with the card
"PURCHASE_RETURN_OR_REFUND"	Credit	Refund of a previous purchase
"PURCHASE_WITH_CASHBACK"	Debit	Purchase with additional cashout in store
"QUASI_CASH"	Debit	Quasi cash transactions represent the purchase of foreign currencies or items (including, but not limited to, casino chips, cryptocurrencies, money orders, lottery tickets and travellers cheques) which may be convertible to cash
"UNIQUE_MCC_TRANSACTION"	Debit
"WITHDRAWAL"	Debit	Withdrawal at ATM
"UNKNOWN"	Unknow	Unknown

Check for the Card Transaction Details page for examples : Card Transaction - Details