Retrieves a transaction by ID

Request

GET {{baseURL}}/v2/transactions/{{transactionId}}

This endpoint retrieves a transaction by ID.

See Also:
To list transactions, see GET /v2/transactions.
To create a new transaction, see POST /v2/transactions.
To capture a transaction, see POST /v2/transactions/{transactionId}/capture.

Security

Bearer

Path

transactionIdstring, (uuid)required

Specifies the transaction identifier.

Example:3c25d7e4-dfe0-4ede-a3f0-fb280cac281c

curl -i -X GET \
  https://sandbox.api.flute.com/v2/transactions/3c25d7e4-dfe0-4ede-a3f0-fb280cac281c \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Bodyapplication/json

transactionIdstring or null, (uuid)

Indicates the attached transaction identifier.

This value is available after processing.

Example: f01339ec-8184-48c7-b58d-0780d6499ef4

Example:"f01339ec-8184-48c7-b58d-0780d6499ef4"

transactionDateTimestring, (date-time)

Indicates the date-time (in an ISO 8601 date-time format) of the transaction.

Example: 2026-05-05T14:30:42.938Z

Example:"2026-05-05T14:30:42.938Z"

transactionStatusstring

Indicates the aggregated transaction status.

Valid values are:

Status	Description
Authorized	Payment approved but funds not yet captured.
Cancelled	Transaction stopped before it completed.
Captured	Approved funds collected from the card.
ChargedBack	Cardholder disputed the charge with their bank.
Cleared	Funds finished processing and settled.
Declined	Payment rejected by the bank or processor.
Failed	Transaction could not complete due to an error.
Held	Transaction paused and awaiting release.
HeldByProcessor	Processor paused the transaction for review.
Informational	Record used for reference only, not a live charge.
InProgress	Transaction is still processing.
PartiallyAuthorized	Only part of the requested amount was approved.
Pending	Transaction is waiting for a result.
Refunded	Funds returned to the cardholder.
Scheduled	Transaction set to run at a future time.
Settled	Funds moved from issuer to the merchant account.
Verified	Card or account confirmed as valid.
Voided	Authorization canceled before capture.

Example: Authorized

Enum:"Authorized""Captured""Voided""Refunded""Verified""Settled""PartiallyAuthorized""Informational""Scheduled""Cancelled"

Example:"Authorized"

transactionTypestring

Identifies the type of the transaction.

Valid values are:

Type	Explanation
AchCancel	Cancels a pending ACH transaction.
AchCredit	Sends funds to a bank account.
AchDebit	Pulls funds from a bank account.
AchHold	Holds an ACH transaction temporarily.
AchRefund	Returns funds from an ACH payment.
AchUnHold	Releases a held ACH transaction.
Authorization	Reserves funds for later capture.
Capture	Collects funds from an authorization.
CardAuthentication	Confirms cardholder identity before payment.
Refund	Returns funds from a transaction.
RefundWORef	Refunds a transaction without a reference.
Sale	Authorizes and captures funds together.
Settle	Submits a batch for final processing.
TipAdjustment	Changes the tip amount on a transaction.
Void	Cancels a transaction before settlement.

Example: AchDebit

Enum:"AchCancel""AchCredit""AchDebit""AchHold""AchRefund""AchUnHold""Authorization""Capture""CardAuthentication""Refund"

Example:"AchDebit"

cardTokenTypestring

Indicates the type of the token.

Valid values are:

Type	Meaning
Local	Tokenized and stored within Flute's own vault
Network	Tokenized through a card network, such as Visa or Mastercard, using their network tokenization services

Example: Local

Enum:"Local""Network"

Example:"Local"

paymentMethodTypestring

Identifies the payment method type.

Valid values are:

Type	Description
ACH	Payment made through an ACH bank transfer.
Card	Payment made with a credit or debit card.
Cash	Payment made with physical currency.

Example: Card

Enum:"Card""ACH""Cash"

Example:"Card"

referenceIdstring or null, [ 0 .. 36 ] characters

Indicates a reference identifier provided by the merchant.

This is included in the duplicate-check key. It allows the same card and amount combination to be charged multiple times when the reference identifiers are different.

Example: REF-EXT-12345

Example:"REF-EXT-12345"

originalTransactionIdstring or null, (uuid)

Indicates the original transaction identifier.

This value will be provided if the current transaction is a card refund.
Otherwise, it will be null or omitted.

Example: 4d5d19c0-7b8c-4d9e-0f1a-2b3c4d5e6f92

Example:"4d5d19c0-7b8c-4d9e-0f1a-2b3c4d5e6f92"

processedAmountnumber or null, (double), decimal places <= 2

Indicates the transaction amount (in USD).

The value will be null until the transaction is completed.

Example: 87.39

Example:87.39

refundDetailsobject

Indicates an object detailing the refund posture for a transaction that can be refunded.

This value is null on transactions that are themselves refunds or credits. Those cannot be refunded again.

currencyCodestring or null

Identifies the transaction's currency code (in uppercase ISO 4217 currency code).

Example: USD

Default:"USD"

Example:"USD"

pricingTypestring or null

Identifies the type of pricing.

This value is required only when Dual Pricing is enabled.

Valid values are:

Status	Explanation
Card	The transaction uses the card price, which may include a surcharge.
Cash	The transaction uses the cash price, which may include a cash discount.

Example: Card

Enum:"Card""Cash"

Example:"Card"

merchantIdstring, (uuid)

Identifies the merchant identifier.

Example: 5611f824-48ef-4255-978d-91ce13953bbd

Example:"5611f824-48ef-4255-978d-91ce13953bbd"

paymentProcessorIdstring or null, (uuid)

Identifies the payment processor.

Defaults to merchant's default processor.

Example: 76215e54-a85b-4d42-9553-163fe393cb02

Example:"76215e54-a85b-4d42-9553-163fe393cb02"

customerIdstring or null, (uuid)

Identifies the customer to link this payment method to.

This value may be null when this payment method is an orphan owned by the merchant directly. An orphan payment method is a payment method in the merchant's vault but has no customer record associated with it.

Example: 8fa8e727-73c6-436e-b56f-6f55aabf3b1c

Example:"8fa8e727-73c6-436e-b56f-6f55aabf3b1c"

batchIdstring or null, (uuid)

Indicates the batch settlement identifier.

Example: 42df0a13-4bf4-48f8-929c-08a379c0a0d6

Example:"42df0a13-4bf4-48f8-929c-08a379c0a0d6"

amountBreakdownobject

Indicates an object detailing the amount breakdown details.

cardDetailsobject or null

Indicates the card details exposed on transaction responses.

These may be masked for sensitive fields or fully displayed for non-sensitive fields.

achDetailsobject or null

Indicates ACH account details exposed on transaction responses.

These may be masked for sensitive fields or fully displayed for non-sensitive fields.

processorDetailsobject

Payment processor identifiers for a transaction.

declineDetailsobject

Indicates an object detailing a declined or failed transaction. This value is null when the transaction was approved or is pending.

addressVerificationServiceResponseobject

Indicates the AVS (address verification service) response for card payments.

transactionEventsArray of objects or null

Indicates an object detailing the chronological list of events that occurred for this transaction.

sourceobject

Indicates an object describing the origination of the transaction.

Response

A completed card sale transaction with AVS (address verification service) response and amount breakdown.

{
  "transactionId": "f184155d-5737-440c-abd4-1b58f0b9119c",
  "transactionDateTime": "2025-06-15T14:30:56.264Z",
  "status": "Captured",
  "paymentMethodType": "Card",
  "referenceId": "REF-001",
  "processedAmount": 115.5,
  "currencyCode": "USD",
  "amountBreakdown": {
    "baseAmount": 100,
    "tipAmount": 10,
    "surchargeAmount": 5.5,
    "discountAmount": 0
  },
  "addressVerificationServiceResponse": {
    "action": "Allow",
    "responseCode": "Y",
    "description": "Address and postal code match"
  },
  "cardDetails": {
    "maskedCardNumber": "411111******1111",
    "cardType": "Visa",
    "creditDebitType": "Credit"
  },
  "achDetails": null,
  "transactionEvents": [
    {
      "type": "Sale",
      "status": "Approved",
      "amount": 115.5,
      "dateTime": "2025-06-15T14:30:56.264Z",
      "processorResponse": {
        "processorName": "TSYS",
        "responseCode": "00",
        "responseMessage": "APPROVAL",
        "responseDefinition": "Approved"
      }
    }
  ]
}