Get Transaction Authorizations

Returns the list of authorization records (initial authorizations, reversals, increments, etc.) associated with a specific transaction.

URL test:

https://test.lightcms.io/cms/v1/trancore/v1/trancore/transactions/{id}/authorizations

Method

GET

Path items

/v1/trancore/transactions/{id}/authorizations

Parameters

Parameter	Location	Type	Example	Description	Required
id	path	integer	123456	Transaction identifier (internal AuthCore ID).	Yes
x-idempotency-key	header	string	1	Idempotency key – guarantees safe retries.	Yes
x-tenant	header	string	1	Tenant identifier (multi‑tenant deployments).	Yes

Example request

    curl -X GET "https://test.lightcms.io/cms/v1/trancore/v1/trancore/transactions/123456/authorizations" \
         -H 'accept: */*' \
         -H 'x-idempotency-key: 1' \
         -H 'x-tenant: 1'

Responses

200 - OK

Status Code: 200 OK

[
  {
    "id": 10,
    "cardId": 2,
    "plasticId": 2,
    "processor": "ENFUCE",
    "messageFormatVersion": 1,
    "transactionType": "RTL",
    "reqType": "BASE",
    "isAdvice": true,
    "isNegativeAdvice": true,
    "isReversal": false,
    "authorizationResult": "NEGATIVE_ADVICE",
    "systemTransactionDatetime": "2024-11-06T11:12:42Z",
    "localTransactionDatetime": "2024-11-06T11:12:41",
    "messageReferenceId": "N49749729100",
    "authRecordReferenceId": "49749729100",
    "authRecordActionReferenceId": "7c95ed59-9f59-4a5c-bb47-79b3beb72c5d",
    "traceId": "dc659da1f2c21ee3e3413801710b72f2",
    "transactionDirection": "DEBIT",
    "effectiveAmount": 49,
    "oldEffectiveAmount": 0,
    "transactionOriginalCurrency": "CZK",
    "effectiveAmountIssuerCurrency": 49,
    "oldEffectiveAmountIssuerCurrency": 0,
    "issuerCurrency": "CZK",
    "merchantInitiated": false,
    "cardEntryMode": "MANUAL_ENTRY",
    "cardholderPresent": true,
    "cardHolderVerifications": "THREE_DS",
    "partialApprovalCapable": false,
    "partialApprovalAmount": "0",
    "retrievalReferenceNumber": "431111426395",
    "merchantId": "699180001      ",
    "cardAcceptorName": "KLIENT.SEZNAM.CZ",
    "cardAcceptorCity": "PRAHA",
    "cardAcceptorCountryCode": "CZE",
    "acquirerId": "414892",
    "acquirerCountry": "CZE",
    "terminalId": "577353  ",
    "mccCode": "7311",
    "mccCodeDescription": "7311 Advertising Services",
    "mccGroup": "RETAIL",
    "transactionStatus": "NEGATIVE_ADVICE",
    "simpleResponseCode": "RESTRICED_CARD",
    "tokenId": "45458****45677",
    "cardTransactionId": 10,
    "accountId": "213-22224444",
    "accountProcessorId": "5325233",
    "pairingAuthorizationVsClearing": "1.0",
    "schemeTransactionLinkId": "485257329267777",
    "authorizationResultDetail": "DENIED_RESTRICTIONS"
  }
]

Parameter	Location	Type	Description
id		integer	Internal identifier of the authorization record.
cardId		integer	CMS internal card identifier linked to this authorization.
plasticId		integer	Identifier of the physical plastic (if applicable).
processor		string	Processor handling the transaction (e.g., ENFUCE).
messageFormatVersion		integer	Version of the message format.
transactionType		string	Transaction type code (RTL, ECP, …).
reqType		string	Request type (BASE, RECURRENT, …).
isAdvice		boolean	Indicates if this is an advisory transaction.
isNegativeAdvice		boolean	Indicates if this is a negative‑advice transaction.
isReversal		boolean	true if the record represents a reversal.
authorizationResult		string	Result of the authorization (APPROVED, NEGATIVE_ADVICE, …).
systemTransactionDatetime		string	System timestamp (UTC) of the transaction (ISO‑8601).
localTransactionDatetime		string	Local timestamp of the transaction (ISO‑8601, no timezone).
messageReferenceId		string	Unique identifier for the message (used for tracing).
authRecordReferenceId		string	Identifier of the auth record in the upstream system.
authRecordActionReferenceId		string	Identifier of the specific action within the auth record.
traceId		string	Correlation trace identifier.
transactionDirection		string	Direction of funds flow (DEBIT, CREDIT).
effectiveAmount		number	Amount after any conversions, in transaction currency.
oldEffectiveAmount		number	Previous effective amount (if applicable).
transactionOriginalCurrency		string	ISO‑4217 code of the original transaction currency.
effectiveAmountIssuerCurrency		number	Amount converted to issuer currency.
oldEffectiveAmountIssuerCurrency		number	Previous issuer‑currency amount (if applicable).
issuerCurrency		string	ISO‑4217 code of the issuer’s currency.
merchantInitiated		boolean	true if the transaction was initiated by the merchant.
cardEntryMode		string	How the card data was captured (MANUAL_ENTRY, CONTACTLESS, …).
cardholderPresent		boolean	true if the cardholder was present.
cardHolderVerifications		string	Verification method used (THREE_DS, PIN, …).
partialApprovalCapable		boolean	Indicates if partial approval is supported.
partialApprovalAmount		string	Amount approved partially (if applicable).
retrievalReferenceNumber		string	Retrieval Reference Number (RRN) assigned by the acquirer.
merchantId		string	Merchant identifier.
cardAcceptorName		string	Name of the merchant/acceptor.
cardAcceptorCity		string	City of the merchant/acceptor.
cardAcceptorCountryCode		string	Country code of the merchant/acceptor (ISO‑3166‑1 alpha‑2).
acquirerId		string	Identifier of the acquiring bank/network.
acquirerCountry		string	Country code of the acquirer.
terminalId		string	Terminal identifier at the merchant.
mccCode		string	Merchant Category Code.
mccCodeDescription		string	Human‑readable description of the MCC.
mccGroup		string	MCC group/category.
transactionStatus		string	Overall status of the transaction (NEGATIVE_ADVICE, APPROVED, …).
simpleResponseCode		string	Simplified response code (e.g., RESTRICED_CARD).
tokenId		string	Token identifier (masked).
cardTransactionId		integer	Internal identifier of the card transaction.
accountId		integer	Internal Account ID.
accountProcessorId		integer	Processor Account ID.
pairingAuthorizationVsClearing		integer	ID used to pair Authorization and Clearing.
schemeTransactionLinkId		integer	Transaction link ID created by scheme.
authorizationResultDetail		integer	Authorization result detail for specific scenarios: DENIED_RESTRICTIONS, DENIED_LIMIT_EXCEEDED, DENIED_SUSPECTED_FRAUD,DENIED_CARD_BLOCKED.

500 - Internal error

Status Code: 500 Internal error

{
  "timestamp": "2025-07-22T13:09:02.348+02:00",
  "status": 500,
  "error": "Internal Server Error",
  "path": "/cms/v1/trancore/transactions/123456/authorizations"
}