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

# Get Transaction

`GET /v3/transactions/{traceId}`

## Request

- Base URL: `https://testpayarcconnectapi.payarc.net`
- URL: `https://testpayarcconnectapi.payarc.net/v3/transactions/{traceId}`
- Auth: HTTP bearer

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.dev/payarc/apis/payarc-connect-v3.md) - [All operations](https://skmtc.dev/payarc/apis/payarc-connect-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/payarc/apis/payarc-connect-v3/revisions/78418d530627?raw)