Skip to content

Retrieve Transaction Disputes

Retrieves all dispute records linked to a specific transaction.

URL test:

    https://test.lightcms.io/trancore/v1/trancore/transactions/987654321/disputes

Method:

GET

Path items:

/trancore/transactions/{id}/disputes

Parameters:

Parameter Location Type Example Description Required
id path integer 987654321 Transaction identifier (numeric). Yes

Example:

    curl -X GET "https://test.lightcms.io/trancore/v1/trancore/transactions/987654321/disputes" \
         -H 'accept: */*'

Responses:

200 - OK

Status Code: 200 OK 

[
  {
    "id": 123456789,
    "cardId": "987654321",
    "recordId": "250",
    "processor": "VISA",
    "messageFormatVersion": 1,
    "transactionType": "PURCHASE",
    "isReversal": true,
    "systemTransactionDatetime": "2023-12-01T12:34:56Z",
    "localTransactionDatetime": "2023-12-01T14:34:56+02:00",
    "batchRecordReferenceId": "BATCH12345",
    "schemaTraceId": "SCHEMA12345",
    "traceId": "TRACE12345",
    "transactionId": "TXN123456789",
    "authRecordReferenceId": "987654321",
    "acquirerReferenceNumber": "ARN12345",
    "transactionDirection": "DEBIT",
    "effectiveAmount": 100.5,
    "transactionOriginalCurrency": "USD",
    "effectiveAmountIssuerCurrency": 100.5,
    "issuerCurrency": "EUR",
    "feeType": "SERVICE_FEE",
    "feeAmount": 1.5,
    "feeCurrency": "USD",
    "feeAmountIssuerCurrency": 1.4,
    "merchantInitiated": true,
    "cardEntryMode": "CHIP_READ",
    "cardholderPresent": true,
    "cardHolderVerifications": "PIN",
    "retrievalReferenceNumber": "RRN123456789",
    "merchantId": "MERCHANT123",
    "subMerchantName": "Best Buy Electronics",
    "cardAcceptorName": "Best Buy",
    "cardAcceptorNameCity": "New York",
    "cardAcceptorCountryCode": "USA",
    "acquirerId": "ACQ123",
    "terminalId": "TERM12345",
    "mccCode": "5411",
    "approvalCode": "APPROVED12345",
    "tokenId": "TOKEN123",
    "tokenCategory": "APPLE_PAY",
    "deviceType": "MOBILE",
    "interchangeFeeAmount": 0.3,
    "interchangeFeeFundsDirection": "DEBIT",
    "dccIndicator": "ENABLED",
    "ecommerceIndicator": "ECOMMERCE",
    "posEnvironment": "COF",
    "cashbackAmount": 20,
    "settlementService": "STANDARD",
    "posTerminalCapability": "CONTACTLESS",
    "settlementProcessingDate": "2023-12-02",
    "usageCode": "01",
    "reasonCode": "05",
    "reimbursementAttribute": "FULL",
    "chargeBackRefId": "CHB123456789",
    "memberMessageText": "Transaction approved",
    "chipConditionCode": "Y",
    "clearingFlag": "C",
    "cardTransactionId": 987654321,
    "pairingAuthorizationVsClearing": "1.00_R01",
    "pairingClearingVsClearing": "1.00_P01"
  }
]

Parameter Location Type Description
id root integer Internal identifier of the dispute record.
cardId root string CMS card identifier involved in the dispute.
recordId root string Identifier of the clearing record associated with the dispute.
processor root string Processor name (e.g., VISA).
messageFormatVersion root integer Version of the message format.
transactionType root string Type of the transaction (e.g., PURCHASE).
isReversal root boolean Indicates if the dispute is a reversal.
systemTransactionDatetime root string System timestamp of the transaction (ISO‑8601).
localTransactionDatetime root string Local timestamp of the transaction (ISO‑8601 with offset).
batchRecordReferenceId root string Batch reference identifier.
schemaTraceId root string Schema trace identifier.
traceId root string Trace identifier for tracing across systems.
transactionId root string Transaction identifier (may be alphanumeric).
authRecordReferenceId root string Authorization record reference ID.
acquirerReferenceNumber root string Reference number assigned by the acquiring bank.
transactionDirection root string Direction of the transaction (DEBIT, CREDIT, NON_FINANCIAL).
effectiveAmount root number Effective amount in original currency.
transactionOriginalCurrency root string ISO‑4217 code of the original transaction currency.
effectiveAmountIssuerCurrency root number Effective amount converted to issuer currency.
issuerCurrency root string ISO‑4217 code of the issuer currency.
feeType root string Type of fee applied (e.g., SERVICE_FEE).
feeAmount root number Fee amount in original currency.
feeCurrency root string Currency of the fee (original).
feeAmountIssuerCurrency root number Fee amount converted to issuer currency.
merchantInitiated root boolean Whether the transaction was initiated by the merchant.
cardEntryMode root string Card entry mode (e.g., CHIP_READ).
cardholderPresent root boolean Indicates if the cardholder was present.
cardHolderVerifications root string Verification method used (e.g., PIN).
retrievalReferenceNumber root string Retrieval Reference Number (RRN).
merchantId root string Merchant identifier.
subMerchantName root string Sub‑merchant name.
cardAcceptorName root string Name of the card acceptor (merchant).
cardAcceptorNameCity 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.
terminalId root string Terminal identifier.
mccCode root string Merchant Category Code.
approvalCode root string Approval code from the processor.
tokenId root string Token identifier (masked or partial).
tokenCategory root string Token category (e.g., APPLE_PAY).
deviceType root string Device type used for the transaction (e.g., MOBILE).
interchangeFeeAmount root number Interchange fee amount.
interchangeFeeFundsDirection root string Direction of interchange fee funds (DEBIT/CREDIT).
dccIndicator root string Dynamic Currency Conversion indicator (ENABLED/DISABLED).
ecommerceIndicator root string E‑commerce indicator (ECOMMERCE/NON_ECOMMERCE).
posEnvironment root string Point‑of‑sale environment (e.g., COF).
cashbackAmount root number Cashback amount applied.
settlementService root string Settlement service used (e.g., STANDARD).
posTerminalCapability root string POS terminal capability (e.g., CONTACTLESS).
settlementProcessingDate root string Date of settlement processing (YYYY‑MM‑DD).
usageCode root string Usage code for the transaction.
reasonCode root string Reason code for the dispute.
reimbursementAttribute root string Reimbursement attribute (e.g., FULL).
chargeBackRefId root string Charge‑back reference identifier.
memberMessageText root string Message text associated with the dispute.
chipConditionCode root string Chip condition code.
clearingFlag root string Clearing flag status.
cardTransactionId root integer Identifier of the original card transaction.
pairingAuthorizationVsClearing root string Pairing identifier between authorization and clearing.
pairingClearingVsClearing root string Pairing identifier between clearing records.