---
title: "Get Transaction"
method: GET
path: "/v3/transactions/{traceId}"
tags: ["Get Transaction"]
---

# Get Transaction

`GET /v3/transactions/{traceId}`

This API endpoint gets transaction details based on the trace ID associated with the transaction.

## Path parameters

- `traceId` string, uuid, required

## Headers

- `Authorization` string, required
- `X-Idempotency-Key` string, uuid, required

## Response `200`

Transaction information.

- CallbackResponse — The payload posted to the callbackURL when the terminal transaction processing completes.
  - `transactionId` string — Transaction identifier from the original API request.
  - `transType` 'SALE' | 'REFUND' | 'VOID' | 'AUTH' | 'POSTAUTH' — Transaction type of the given transaction.
  - `status` string — Terminal callback status text (free-form). <br> Examples include APPROVED, DECLINE, DUP TRANSACTION, TIMEOUT. <br> Always inspect this field to determine the final transaction outcome.
  - `chargeId` string — Processor/network charge identifier when a charge is created.
  - `authCode` string — Authorization code for approved transactions when available.
  - `amount` object — Amount values in cents (minor units).
    - `total` number — Requested total amount for the transaction.
    - `subtotal` number — Requested pre-tip and pre-tax subtotal.
    - `approved` number — Approved amount for this transaction result.
    - `currency` string — The three-letter alphabetic ISO currency code.
    - `tip` number, nullable — Approved amount for tip.
    - `tax` number, nullable — Approved amount for tax.
  - `card` object — Card information returned by the processor when available.
    - `brand` string — Card brand.
    - `entryMode` string — Card capture method (for example CONTACTLESS, CHIP, SWIPE, MANUAL).
    - `last4` string — Last four digits of the card number.
  - `processor` object — Processor response metadata for the transaction attempt.
    - `type` 'TRADITIONAL' | 'PAYFAC' — Processor used for this transaction.
    - `responseCode` string — Processor response code.
    - `responseText` string — Processor response text, indicates the processor's reason for a non-success response.
  - `timestamp` string, date-time — UTC timestamp when this callback payload was generated.
  - `traceId` string, uuid — Correlation identifier matching the initial API response traceId.
  - `metadata` object — Original caller-supplied metadata from the transaction request, echoed back for end-to-end correlation.
  - `error` object, nullable — Error details for API/processing errors when available. The error object is ONLY included on API errors, not processor declines, timeouts, etc.
    - `code` string — The corresponding error code.
    - `message` string — The message that corresponds to the error.
    - `friendlyMessage` string — A friendlier, more descriptive message in regards to the error message.

## Other responses

- `400` — Invalid Request

---

[API](https://skmtc.net/payarc/apis/payarc-sandbox.md) · [All operations](https://skmtc.net/payarc/apis/payarc-sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payarc/payarc-sandbox/revisions/face82bdd778/schema)