# TransactionHistoryItem

A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.

## Fields
- `id` (string(uuid))
- `transactionId` (string(uuid))
- `stage` ([TransactionStage](https://devportal.demo.winkpg.io/docs/api/models/TransactionStage.md)): Represents the stage of a transaction within the transaction management workflow.
  Values:
  - `Created`
  - `Validated`
  - `Enriched`
  - `Screened`
  - `Authorized`
  - `Finalized`
  - `Captured`
  - `Completed`
  - `Reversed`
  - `Refunded`
  - `Voided`
  - `SplitTenderPending`: A partial approval is holding a reduced authorization and the gateway is waiting for a decision: accept the lesser amount, void it, or start a split tender for the shortfall. Non-terminal: the transaction leaves this stage once Transaction.PartialApprovalData.Disposition moves off PartialApprovalDisposition.Pending, or when the acknowledgment deadline elapses and the gateway voids it.
  - `Rejected`
  - `Declined`
  - `Failed`
  - `PolicyRejected`: Auth succeeded at the processor but a post-authorization denylist rule matched (AVS or CVV response code). A reversal or void was issued and the transaction is permanently rejected by gateway policy.
- `detailsJson` (string): (nullable)
- `creatorId` (string(uuid)): The ID of the user who created this entity.
- `creationTime` (string(date-time)): The date and time when this entity was created.
- `operationId` (string): (nullable)
- `lifecycleStatus` (string): The merchant-facing lifecycle status this entry was published under, or  `null` when the entry carries none. (nullable)
- `lifecycleOccurredAtUtc` (string(date-time)): When the event named by `lifecycleStatus` actually occurred, or  `null` when the entry's own `creationTime` is that instant. (nullable)
- `linkedReceiptId` (string(uuid)): The ID of the receipt generated for this timeline entry, if any. (nullable)
- `linkedReceiptType` ([ReceiptType](https://devportal.demo.winkpg.io/docs/api/models/ReceiptType.md)): The type of the linked receipt. (nullable)
  Values:
  - `Authorization`: Receipt generated after a successful authorization.
  - `Capture`: Receipt generated after a capture/settlement.
  - `Refund`: Receipt generated after a full refund.
  - `PartialRefund`: Receipt generated after a partial refund. Multiple partial refund receipts may exist on a single transaction, each with a distinct sequence number.
  - `Void`: Receipt generated after a void.
  - `Reversal`: Receipt generated after a full reversal: the entire approved amount has been released back to the issuer. Distinguished from PartialReversal so the transaction-detail / explorer pages can show the lifecycle event clearly.
  - `OnDemand`: Receipt generated on-demand from the UI (legacy/fallback for pre-module transactions).
  - `PartialReversal`: Receipt generated after a partial reversal. Multiple partial reversal receipts may exist on a single transaction (one per reversal operation), each with a distinct sequence number.
  - `SplitTenderSummary`: Summary receipt for a completed split tender group: the order total, what each tender in the group authorized, and the combined authorized amount. Generated once per group, after the final tender completes, in addition to the per-tender receipts.
- `linkedReceiptSequenceNumber` (integer(int32)): The sequence number of the linked receipt within the transaction. (nullable)
- `subHistory` (array<[TransactionHistoryItem](https://devportal.demo.winkpg.io/docs/api/models/TransactionHistoryItem.md)>): (nullable)

## See also

- [All documentation](https://devportal.demo.winkpg.io/llms.txt): the machine-readable index of every public page on this site.