---
title: "Retrieve status of a transaction"
method: GET
path: "/status/{apiKey}/getByUuid/{uuid}"
tags: ["status"]
---

# Retrieve status of a transaction

`GET /status/{apiKey}/getByUuid/{uuid}`

## Request

- Base URL: `https://gateway.tillpayments.com/api/v3`
- URL: `https://gateway.tillpayments.com/api/v3/status/{apiKey}/getByUuid/{uuid}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/tillpayments/apis/till-payments-gateway/docs/status/:apiKey/getByUuid/:uuid/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `apiKey` string, required
- `uuid` string, required

## Response `200`

Status response

- StatusResponse
  - `success` boolean
  - `transactionStatus` 'SUCCESS' | 'PENDING' | 'REDIRECT' | 'CANCELLED' | 'ERROR'
  - `uuid` string
  - `merchantTransactionId` string
  - `adapterMerchantTransactionId` string: Adapter/PSP-side merchant transaction identifier recorded for transaction matching and reconciliation. Omitted when unavailable.
  - `purchaseId` string
  - `transactionType` 'DEBIT' | 'CAPTURE' | 'DEREGISTER' | 'PREAUTHORIZE' | 'REFUND' | 'REGISTER' | 'VOID' | 'CHARGEBACK' | 'CHARGEBACK-REVERSAL' | 'PAYOUT' | 'INCREMENTAL-AUTHORIZATION' | 'DISPUTE' | 'DISPUTE-REVERSAL'
  - `transactionSubType` 'cb-resolved' | 'cb-reversal-resolved': Only present if transaction has a subType
  - `paymentMethod` string
  - `amount` string
  - `currency` string
  - `surchargeAmount` string
  - `totalAmount` string
  - `schedules` object
  - `errors` TransactionError[]
    - `message` string
    - `code` integer
    - `adapterMessage` string
    - `adapterCode` string
  - `chargebackData` ChargebackData
    - `originalUuid` string
    - `originalMerchantTransactionId` string
    - `amount` string
    - `currency` string
    - `reason` string
    - `chargebackDateTime` string
    - `disputeData` TransactionDisputeData
      - `adapterDisputeId` string
      - `status` string
      - `reasonText` string
      - `reasonCode` string
      - `metaData` string
      - `createdAt` string
      - `modifiedAt` string
  - `chargebackReversalData` ChargebackReversalData
    - `originalUuid` string
    - `originalMerchantTransactionId` string
    - `chargebackUuid` string
    - `amount` string
    - `currency` string
    - `reason` string
    - `reversalDateTime` string
  - `extraData` ExtraData
  - `merchantMetaData` string
  - `returnData` union
    - ReturnCardData
      - `_TYPE` 'cardData'
      - `type` string
      - `firstName` string
      - `lastName` string
      - `country` string
      - `cardHolder` string
      - `expiryMonth` string
      - `expiryYear` string
      - `binDigits` string
      - `firstSixDigits` string
      - `lastFourDigits` string
      - `fingerprint` string
      - `binBrand` string
      - `binBank` string
      - `binType` string
      - `binLevel` string
      - `binCountry` string
      - `binSegment` 'Consumer' | 'Business' | 'Commercial' | 'Government' | 'Unknown'
      - `binRawData` object
        - `type` string
        - `data` object
      - `threeDSecure` string
      - `eci` string
      - `merchantAdviceCode` string
      - `parsedMerchantAdviceCode` string
      - `schemeTransactionIdentifier` string
      - `schemeLifecycleIdentifier` string
      - `referenceSchemeLifecycleIdentifier` string
      - `cardUpdateStatus` 'updated' | 'contact' | 'new-expiry' | 'closed': Account updater transaction status
      - `cardUpdatedAt` string, date: Last run of the batch
      - `cardUpdatePausedUntil` string, date: Updates paused until this date
    - ReturnPhoneData
      - `_TYPE` 'phoneData'
      - `phoneNumber` string
      - `country` string
      - `operator` string
    - ReturnIbanData
      - `_TYPE` 'ibanData'
      - `accountOwner` string
      - `iban` string
      - `bic` string
      - `mandateId` string
      - `mandateDate` string
      - `bankName` string
      - `bankBranchName` string
      - `country` string
    - ReturnWalletData
      - `_TYPE` 'walletData'
      - `walletReferenceId` string
      - `walletOwner` string
      - `walletType` string
  - `payByLinkData` PayByLinkData
    - `payByLink` boolean
    - `sendViaEmail` boolean
  - `customer` Customer
    - `identification` string
    - `firstName` string
    - `lastName` string
    - `birthDate` string
    - `gender` 'M' | 'F'
    - `billingAddress1` string
    - `billingAddress2` string
    - `billingCity` string
    - `billingPostcode` string
    - `billingState` string
    - `billingCountry` string
    - `billingPhone` string
    - `shippingFirstName` string
    - `shippingLastName` string
    - `shippingCompany` string
    - `shippingAddress1` string
    - `shippingAddress2` string
    - `shippingCity` string
    - `shippingPostcode` string
    - `shippingState` string
    - `shippingCountry` string
    - `shippingPhone` string
    - `company` string
    - `email` string
    - `emailVerified` boolean
    - `ipAddress` string
    - `nationalId` string
    - `extraData` ExtraData
    - `paymentData` union
      - IbanData
        - `ibanData` object
          - `iban` string
          - `bic` string
          - `mandateId` string
          - `mandateDate` string
      - WalletData
        - `walletData` object
          - `walletReferenceId` string
          - `walletOwner` string
          - `walletType` string
  - `customerProfileData` CustomerProfileData
    - `profileGuid` string
    - `customerIdentification` string
    - `paymentToken` string
    - `markAsPreferred` boolean
  - `tracingData` TracingData
    - `transactions` object[]
      - `uuid` string
      - `sequence_number` string
      - `status` string
      - `connector` object
        - `guid` string
        - `adapter_name` string
        - `brand` string

## Changes

- **2026-11-07** `42c40d316a83`: 6 info
  - added the optional property `adapterMerchantTransactionId` to the response with the `200` status
  - added the optional property `customerProfileData/paymentToken` to the response with the `200` status
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/referenceSchemeLifecycleIdentifier` to the response with the `200` status
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/schemeLifecycleIdentifier` to the response with the `200` status
  - …2 more
- **2025-04-27** `5d765c6bfe90`: 4 info
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/binRawData` to the response with the `200` status
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/binSegment` to the response with the `200` status
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/cardUpdatePausedUntil` to the response with the `200` status
  - added the optional property `tracingData` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/tillpayments/apis/till-payments-gateway/changes/status/:apiKey/getByUuid/:uuid/get.md)

---

[API](https://skmtc.dev/tillpayments/apis/till-payments-gateway.md) - [All operations](https://skmtc.dev/tillpayments/apis/till-payments-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/tillpayments/apis/till-payments-gateway/revisions/42c40d316a83?raw)