# Tender

object type

ONE applied tender: FSM-LESS by ratified intent (SPEC_CATALOG / — status is always active; the lifecycle is its Payment / the money facts); sysId-LESS (the class); IMMUTABLE — reversal = a NEW refund tender row (negative appliedMinor), never an edit. Posted ONLY by applyTender, refundTender, and the refund writers (refundReturn/posReturn method=cash) — each in ONE transaction with the Order rollup stamp (+ the drawer entries for cash).

## Fields

| Field | Type | Notes |
| --- | --- | --- |
| `id` | [ID](/types/#scalars) `ID!` | No further notes. |
| `type` | [String](/types/#scalars) `String!` | No further notes. |
| `caption` | [String](/types/#scalars) `String!` | The derived display caption — tenderType + currency + signed applied minor; never editable. |
| `status` | [String](/types/#scalars) `String!` | FSM-less: always active. |
| `parentId` | [ID](/types/#scalars) `ID!` | The parent Order. |
| `rootId` | [ID](/types/#scalars) `ID!` | No further notes. |
| `tenderType` | [TenderType](/types/TenderType/) `TenderType!` | The canned tender type (SPEC_REGISTRY row 92). |
| `appliedMinor` | [Int](/types/#scalars) `Int!` | SIGNED minor units APPLIED toward the order balance — positive = payment, negative = a refund tender. |
| `currency` | [String](/types/#scalars) `String!` | The settlement currency — the order currency snapshot. |
| `collectedMinor` | [Int](/types/#scalars) | CASH, positive tenders: the PHYSICAL cash handed over (before change, tip included). |
| `changeMinor` | [Int](/types/#scalars) | CASH: the physical change handed back (the change_given drawer lane). |
| `tipMinor` | [Int](/types/#scalars) | The tip captured at tender. |
| `roundingDeltaMinor` | [Int](/types/#scalars) | The cash-rounding ledger note (settling cash tenders): roundedDue − exactDue — the sale total NEVER changes. |
| `externalCard` | [TenderExternalCard](/types/TenderExternalCard/) | The pinpad capture (external_card tenders only). |
| `fx` | [TenderFx](/types/TenderFx/) | The foreign-cash capture (foreign_cash tenders only). |
| `paymentId` | [ID](/types/#scalars) | The Payment this card tender was spawned by (card tenders only; the payment read tells the processor story). |
| `instrumentId` | [ID](/types/#scalars) | The StoredValueInstrument this tender drew from or credited. |
| `orgCustomerId` | [ID](/types/#scalars) | The OrgCustomer house account this tender charged or credited. |
| `returnId` | [ID](/types/#scalars) | The Return this refund tender settles. |
| `tillSessionId` | [ID](/types/#scalars) | The drawer session a cash tender settled to/paid out of. |
| `reason` | [String](/types/#scalars) | The caller's reason (required on refund tenders). |
| `refs` | [String](/types/#scalars) `[String!]` | Provenance document refs (bounded free strings). |
| `createdAt` | [String](/types/#scalars) `String!` | No further notes. |
| `updatedAt` | [String](/types/#scalars) `String!` | No further notes. |
| `revision` | [ID](/types/#scalars) `ID!` | No further notes. |
| `revisionNum` | [Int](/types/#scalars) `Int!` | No further notes. |

## Used by

- [applyTender](/reference/selling/applyTender/)
- [orderTenders](/reference/reading-your-records/orderTenders/)
- [refundTender](/reference/refunds-and-payment-corrections/refundTender/)
