Retrieve Invalid Authorizations

Retrieves a list of invalid authorization records with optional filtering.

URL test:

    https://test.lightcms.io/trancore/v1/trancore/transactions/authorizations/invalid?processed=false&page=0&size=20

Method:

GET

Path items:

/trancore/transactions/authorizations/invalid

Parameters:

Parameter	Location	Type	Example	Description	Required
processed	query	boolean	false	If omitted returns all records; true → only processed, false → only unprocessed.	No
cardId	query	string	2198	Filter by card ID (some records may contain "UNKNOWN").	No
page	query	integer	0	Zero‑based page index (default 0).	No
size	query	integer	20	Number of records per page (default 20).	No

Example:

    curl -X GET "https://test.lightcms.io/trancore/v1/trancore/transactions/authorizations/invalid?processed=false&page=0&size=20" \
         -H 'accept: */*'

Responses:

200 - OK

Status Code: 200 OK

{
  "id": 17,
  "processor": "PROCESSOR",
  "messageFormatVersion": 1,
  "isAdvice": false,
  "isNegativeAdvice": false,
  "isReversal": false,
  "localTransactionDatetime": "2025-12-30T12:00:09",
  "messageReferenceId": "2784695945",
  "authRecordReferenceId": "1317488782",
  "authRecordActionReferenceId": "695945",
  "traceId": "6953a2a9c44802a6de5e776b202f4c5f",
  "effectiveAmount": 1,
  "oldEffectiveAmount": 0,
  "transactionOriginalCurrency": "EUR",
  "effectiveAmountIssuerCurrency": 1,
  "oldEffectiveAmountIssuerCurrency": 0,
  "issuerCurrency": "EUR",
  "retrievalReferenceNumber": "536410695945",
  "merchantId": "7504329",
  "cardAcceptorName": "1*thomas-richter.com",
  "cardAcceptorCity": "Lviv",
  "cardAcceptorCountryCode": "UKR",
  "acquirerId": "421950",
  "mccCode": "7349",
  "accountId": "213-22224444",
  "accountProcessorId": "5325233",
  "invalidCardId": "UNKNOWN",
  "invalidPlasticId": "UNKNOWN",
  "errorDetail": {
    "exceptions": [
      {
        "type": "cz.dobito.authcore.connector.rtps.RtpsInvalidRequestException",
        "message": "Missing card id tag in field 126 for RtpsPurchaseLikeRequestType/CNP\nException Context:\n\t[1:RTPS.RefusalReason=MISSING_F126_TAG_CARD_ID]\n\t[2:RTPS.RequestType=RtpsPurchaseLikeRequestType/CNP]\n---------------------------------"
      }
    ]
  },
  "processed": false
}

Parameter	Location	Type	Description
id	root	integer	Internal identifier of the invalid authorization record.
processor	root	string	Processor name.
messageFormatVersion	root	integer	Version of the message format.
isAdvice	root	boolean	Indicates if the record is an advice.
isNegativeAdvice	root	boolean	Indicates if the advice is negative.
isReversal	root	boolean	Indicates if the record represents a reversal.
localTransactionDatetime	root	string	Local date‑time of the transaction (ISO‑8601).
messageReferenceId	root	string	Reference ID of the original message.
authRecordReferenceId	root	string	Authorization record reference ID.
authRecordActionReferenceId	root	string	Action reference ID within the authorization record.
traceId	root	string	Trace identifier for end‑to‑end tracing.
effectiveAmount	root	number	Effective amount in the original currency.
oldEffectiveAmount	root	number	Previous effective amount before the current update.
transactionOriginalCurrency	root	string	ISO‑4217 code of the original transaction currency.
effectiveAmountIssuerCurrency	root	number	Effective amount converted to issuer currency.
oldEffectiveAmountIssuerCurrency	root	number	Previous effective amount in issuer currency.
issuerCurrency	root	string	ISO‑4217 code of the issuer currency.
retrievalReferenceNumber	root	string	Retrieval Reference Number (RRN).
merchantId	root	string	Merchant identifier.
cardAcceptorName	root	string	Name of the card acceptor (merchant).
cardAcceptorCity	root	string	City of the card acceptor.
cardAcceptorCountryCode	root	string	Country code of the card acceptor (ISO‑3166‑1 alpha‑2).
acquirerId	root	string	Acquirer identifier.
mccCode	root	string	Merchant Category Code.
accountId		integer	Internal Account ID.
accountProcessorId		integer	Processor Account ID.
invalidCardId	root	string	Identifier of the invalid card (often "UNKNOWN").
invalidPlasticId	root	string	Identifier of the invalid plastic (often "UNKNOWN").
errorDetail.exceptions	root	array	List of exception objects detailing why the authorization is invalid.
errorDetail.exceptions.type	root	string	Exception class name.
errorDetail.exceptions.message	root	string	Human‑readable error message.
processed	root	boolean	Indicates whether the record has been processed (true) or not (false).

400 - Bad Request

Status Code: 400 Bad Request

{
  "errorMessage": "Invalid query parameter: `processed` must be true, false, or omitted."
}

Parameter	Location	Type	Description
errorMessage	root	string	Human‑readable description of the validation error.

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/authorizations/invalid"
}

Parameter	Location	Type	Description
timestamp	root	string	ISO‑8601 timestamp when the error occurred.
status	root	integer	HTTP status code (500).
error	root	string	Short description of the error.
path	root	string	The request path that caused the error.