--- title: "Get Transaction Details" method: GET path: "/api/v1/transactions/{traceIdLifeCycle}" tags: ["Transactions"] --- # Get Transaction Details `GET /api/v1/transactions/{traceIdLifeCycle}` ## Request - Base URL: `https://cardsapi-uat-pub.globalprocessing.net` - URL: `https://cardsapi-uat-pub.globalprocessing.net/api/v1/transactions/{traceIdLifeCycle}` - Auth: OAuth 2 - Client credentials - Token URL: `https://uatists.globalprocessing.net/connect/token` scopes: `readWrite` TraceIdLifeCycle is a string unique identifier. Format is BNET-YYYYMMDD-Network reference number ## Path parameters - `traceIdLifeCycle` string, required ## Response `200` Success - TransactionDetailResponse[] - `productName` string, nullable: Gets or sets the name of the product. - `customerReference` string, nullable: Gets or sets the customer reference. - `recordId` integer, required: ID of the Transaction or Auth. - `pubToken` string, required: Public token - `traceIdLifeCycle` string, nullable: string Id which links the satges of an online Transaction. - `transactionId` integer, required: ID of the original Transaction. - `transactionType` 'Load' | 'Unload' | 'TransferFunds' | 'BalanceAdjustment' | 'Fee', nullable: Type of the transaction. - `transactionStatus` string, nullable: Status of the Transaction. - `transactionAmount` number, double: Amount relating to this Transaction. - `transactionCurrency` string, nullable: Transaction Currency. - `transactionDate` string, date-time: Date of this Transaction. - `billingAmount` number, double: Amount billed to the customer. - `billingAmountWithDirection` number, double: Amount billed to the customer * flCredit. - `billingCurrency` string, nullable: Billing Currency. - `processingCode` string, required: Processing code. - `responseStatus` string, nullable: Status returned (Approved/Declined). - `merchantCategoryCode` string, nullable: Merchant Category Code of the purchase. - `merchantCategoryDescription` string, nullable: Merchant category description. - `dateExpiry` string, nullable: Expiry Date. - `posEntry` POSEntryMode: Point Of Service Data Code - `code` string, nullable: Position in POS Data code. - `codeDescription` POSEntryModeDetails[], nullable: Value Description. - `position` integer, nullable: Position in POS Data code. - `value` string, nullable: Position Value. - `description` string, nullable: Value Description. - `bitPositionDescription` string, nullable: Position Description. - `posEntryMode` string, nullable: Entry mode at Point of Sale. - `retrievalReference` string, nullable: Retrieval Reference. - `cardAcceptorIdentificationCode` string, nullable: ID code of the Merchant (Card Acceptor). - `cardAcceptorNameLocation` string, nullable: Location of Merchant (Card Acceptor). - `aid` string, required: Acquirer Id. - `fid` string, required: Financial Id. - `cardAcceptorTerminalIdentification` string, nullable: Merchant code identifying the POS device. - `additionalData` string, nullable: Additional data. - `settlementAmount` number, double: Amount charged. - `settlementCurrency` string, nullable: Settlement Currency. - `authorisationCode` string, nullable: Authorisation code. - `additionalAmounts` string, nullable: Additional charges. - `tillTime` integer: Till time. - `paymentTokenId` integer, required: ID of the card payment token. - `note` string, nullable: Transaction Note - `availableBalance` number, double: Available balance. - `blockedAmount` number, double: Blocked amount. - `fixedFee` number, double: Fixed fee amount - `rateFee` number, double: Rate fee amount - `fxPadding` number, double: Foreign exchange padding amount - `mccPadding` number, double: Mcc padding amount - `stan` string, nullable: System Trace Audit Number - a number generated by Acquirer system, not unique - `messageType` string, nullable: Message type - `iccData` string, nullable: Authorisation Chip Data received in the request - `messageReasonData` string, nullable: Shows why Visa/Mastercard sent the advice message - `additionalResponseData` string, nullable: AVS/CVV/ASI Check Result - `avsStreet` string, nullable: Numbers in the 1st line of address entered by cardholder - `avsPostcode` string, nullable: Numbers in Postcode of address entered by cardholder - `networkData` string, nullable: Network Data(reference number for each originating message) BN Ref(DE063) - `acquirerReferenceData` string, nullable: Acquirer Reference Data (DE031) - Presentment specific - `transactionOriginatingInstitution` string, nullable: Transaction originating Institution ID - `merchant` Merchant: Merchant details of a submitted transaction. - `city` string, nullable: City. - `contact` string, nullable: Contact. - `county` string, nullable: County. - `name` string, nullable: Name. - `nameOther` string, nullable: Alternative name. - `networkId` string, nullable: Network ID. - `postcode` string, nullable: Post code. - `region` string, nullable: Region. - `street` string, nullable: Street. - `taxId` string, nullable: Tax ID. - `telephone` string, nullable: Telephone. - `url` string, nullable: Website url. - `transactionFees` TransactionFeesDetail: Transaction fees details, from Txn_Fees table - `domesticFixedFee` number, double: Domestic Fixed Fee - `domesticRateFee` number, double: Domestic Rate Fee - `nonDomesticFixedFee` number, double: Non-Domestic Fixed Fee - `nonDomesticRateFee` number, double: Non-Domestic Rate Fee - `fxFixedFee` number, double: Exchange Fixed Fee - `fxRateFee` number, double: Exchange Rate Fee - `paymentMethod` string, nullable: Card/Wallet/None - `ehiMode` integer: EHI mode for the product type. - `pos` Pos: Point of Sale data associated with a transaction. - `cardholderPresent` string, nullable: Indicates whether the cardholder was present. - `cardPresent` string, nullable: Indicates whether the card was present. - `cardInput` string, nullable: Card input. - `cardholderAuthenticationMethod1` string, nullable: Card holder authentication method 1. - `cardholderAuthenticationMethod2` string, nullable: Card holder authentication method 2. - `cardholderAuthenticationMethod3` string, nullable: Card holder authentication method 3. - `cardholderAuthenticationMethod4` string, nullable: Card holder authentication method 4. - `cardholderAuthenticationEntity1` string, nullable: Card holder authentication entity 1. - `cardholderAuthenticationEntity2` string, nullable: Card holder authentication entity 2. - `cardholderAuthenticationEntity3` string, nullable: Card holder authentication entity 3. - `cardholderAuthenticationEntity4` string, nullable: Card holder authentication entity 4. - `chipFallback` string, nullable: Chip fall back. - `fraudIndicator` string, nullable: Fraud indicator. - `securityCardholderToMerchant` string, nullable: Description of Security Cardholder to Merchant. - `secure3DAuthenticationMethod` string, nullable: Secure 3D auth method. - `instantFundingNetwork` string, nullable: Instant Funding (Network indicator). - `instantFundingThredd` string, nullable: Instant Funding (Thredd indicator). - `scaExempt` string, nullable: Exempt From SCA. - `scaAssessment` string, nullable: SCA Assessment. - `scaKnowledgeTest` string, nullable: SCA Knowledge test. - `scaPossessionTest` string, nullable: SCA Possession test. - `scaBiometricTest` string, nullable: SCA Biometric test. - `threddDetectedSCAExemption` string, nullable: Thredd detected SCA exemption. - `cardDeviceFormFactor` string, nullable: Card/Device Form Factor - `acquirerExemptSCAIndicator` string, nullable: Acquirer Exempt from SCA Indicator - `authenticationAmountAndCurrencyComparisonResult` string, nullable: Result of the Authentication Amount and Currency comparison - `merchantCardholderInitiatedIndicator` string, nullable: Merchant or cardholder initiated indicator - `merchantInitiatedTransactionTypeIndicator` string, nullable: Merchant Initiated transaction type (or setup of) indicator - `originalTransactionSCAExemptIndicator` string, nullable: Original transaction SCA exempt indicator - `originalTransactionSCAAssessmentResult` string, nullable: Original transaction SCA assessment result - `originalTransactionStatusValue` string, nullable: Original transaction status value - `extendedAuthorizationIndicator` string, nullable: Extended Authorization indicator - `posCapabilities` PosCapabilities: Capabilities of the Point of Sale equipment. - `attended` string, nullable: Attended. - `cardCapture` string, nullable: Card Capture. - `cardholderAuthentication` string, nullable: Cardholder authentication. - `cardInput` string, nullable: Card Input. - `cardOutput` string, nullable: Card Output. - `environment` string, nullable: Environment. - `partialApproval` string, nullable: Partial approval. - `pinCapture` string, nullable: PIN capture. - `purchaseAmountOnlyApproval` string, nullable: Purchase amount only approval. - `terminalOutput` string, nullable: Terminal output. - `terminalType` string, nullable: Terminal Type. - `decodedAdditionalAmount` AdditionalAmount[], nullable: Decoded DE054 - `occurence` string, nullable: Number of Additional Amount - `accountType` 'Load' | 'Unload' | 'TransferFunds' | 'BalanceAdjustment' | 'Fee': Type value - `amountType` 'Load' | 'Unload' | 'TransferFunds' | 'BalanceAdjustment' | 'Fee': Type value - `currencyCode` 'Load' | 'Unload' | 'TransferFunds' | 'BalanceAdjustment' | 'Fee': Type value - `transactionType` 'Load' | 'Unload' | 'TransferFunds' | 'BalanceAdjustment' | 'Fee': Type value - `amount` 'Load' | 'Unload' | 'TransferFunds' | 'BalanceAdjustment' | 'Fee': Type value - `decodedAdditionalResponseData` AdditionalResponseData[], nullable: Decoded DE044 - `description` string, nullable: Description - `value` string, nullable: Value - `networkReferenceID` string, nullable: Network ReferenceID - DGN specific. - `functionCode` string, nullable: Function Code - DGN specific. - `surchargeFee` string, nullable: Surcharge Fee - DGN specific. - `additionalAuthorisationDataDGN` string, nullable: Additional Authorisation Data for DGN - DGN specific. - `transactionDestinationIIC` string, nullable: Transaction Destination Institution ID - DGN specific - `networkID` integer, nullable: ID of the card Network. Visa = 1 or Mastercard = 0 or DGN = 2 - `requestTime` string, date-time: Date and time of Request - `responseTime` string, date-time: Date and time of Response - `diffInReqResp` integer: Difference (in milliseconds) - Difference between MessageResponseTime and MessageReceivedDate - `responseSource` string, nullable: Response Source. [ResponseSource] - `responseReason` string, nullable: Response Reason. [ResponseReason] - `gpsPosData` string, nullable: Option to view GPS POS Data [PosData] - `posData` string, nullable: POS Data - Different to GPS POS Data - `recapDate` string, nullable: Presentment Date from Discover Recap record. - `recapNumber` string, nullable: Unique Presentment number - `currencyCode` string, nullable: Currency Code as per the ISO Alpha Code - `interchangeAmountFee` number, double, nullable: Interchange amount fee. - `interchangeAmountFeeSettlement` number, double, nullable: Interchange amount fee settlement. - `currencyCodeFee` string, nullable: Currency code (Fee). - `currencyCodeFeeSettlement` string, nullable: Currency code (Fee settlement). - `settlementIndicator` string, nullable: Settlement indicator. - `feeType` string, nullable: Fee Type - `feeProcessingCode` string, nullable: Fee processing code - `pds146Value` string, nullable: Pds146 value - `billingCurrencyNumericCode` string, nullable: The billing currency numeric code. - `panReport` integer, nullable: 16-digit private token - `panPubt` integer, nullable: 16-digit public token - `isMFX` boolean, nullable: MultiFx Card transaction Identifier - `description` string, nullable: Transaction description. - `transactionTypeDescription` string, nullable: Description of the transaction type. - `transactionStatusDescription` string, nullable: Description of the Transaction status. - `responseStatusDescription` string, nullable: Description of Response status. - `avsCardResponse` AvsCheckResponse: Returns Postcode, Address from cards table and result of AVS check - `streetAddressDigits` string, nullable: Numbers in the 1st line of address - `postcodeDigits` string, nullable: Numbers in Postcode of address - `postcodeResult` string, nullable: Value from visa_postcode/mcrd_postcode column of AVS_Result table - `addressResult` string, nullable: Value from visa_street/mcrd_street column of AVS_Result table - `avsResponse` string, nullable: AVS check response - `responseCode` string, nullable: Transaction Response code [Response_Code_039] - `posConditionCode` string, nullable: POS condition code. - `visaFleet` VisaFleet - `fleetData` FleetData - `typeOfPurchase` string, nullable - `serviceType` string, nullable - `fuelType` string, nullable - `expandedFuelType` string, nullable - `unitOfMeasure` string, nullable - `quantity` number, double, nullable - `unitCost` number, double, nullable - `grossFuelPrice` number, double, nullable - `netFuelPrice` number, double, nullable - `grossNonFuelPrice` number, double, nullable - `netNonFuelPrice` number, double, nullable - `nonFuelProductCode1` string, nullable - `nonFuelProductCode2` string, nullable - `nonFuelProductCode3` string, nullable - `nonFuelProductCode4` string, nullable - `nonFuelProductCode5` string, nullable - `nonFuelProductCode6` string, nullable - `nonFuelProductCode7` string, nullable - `nonFuelProductCode8` string, nullable - `promptData` PromptData - `odometerReading` string, nullable - `visaFleetServiceId` string, nullable - `fleetWorkOrderNumber` string, nullable - `fleetEmployeeNumber` string, nullable - `fleetTrailerNumber` string, nullable - `evData` EvData - `chargingPowerOutputCapacity` integer, nullable - `chargingReasonCode` string, nullable - `maximumPowerDispensed` integer, nullable - `connectorType` string, nullable - `totalTimePluggedIn` string, nullable - `totalChargingTime` string, nullable - `startTimeOfCharge` string, nullable - `finishTimeOfCharge` string, nullable - `estimatedKmMilesAdded` integer, nullable - `estimatedKmMilesAvailable` integer, nullable - `carbonFootprint` integer, nullable - `invoiceLineItem` VisaFleetInvoiceLineItem[], nullable - `transactionId` integer - `itemSequenceNumber` integer, nullable - `itemDescription` string, nullable - `productCode` string, nullable - `commodityCode` string, nullable - `quantity` number, double, nullable - `unitOfMeasure` string, nullable - `unitCost` number, double, nullable - `discountPerLineItem` number, double, nullable - `lineItemTotal` number, double, nullable - `vatTaxAmount` number, double, nullable - `vatRate` number, double, nullable ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `500`: Server Error ## Changes - **2026-11-03** `a5b5e4fdcf41`: 1 info - endpoint added [Operation history](https://skmtc.dev/thredd/apis/core-cards/changes/api/v1/transactions/:traceIdLifeCycle/get.md) --- [API](https://skmtc.dev/thredd/apis/core-cards.md) - [All operations](https://skmtc.dev/thredd/apis/core-cards/llms.txt) - [OpenAPI document](https://skmtc.dev/thredd/apis/core-cards/revisions/a5b5e4fdcf41?raw)