# PartialApprovalData

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

Durable record of a partial approval: the issuer authorized less than the requested amount,
and the gateway captured the evidence plus the lifecycle of the decision that followed.

## Fields
- `disposition` ([PartialApprovalDisposition](https://devportal.demo.winkpg.io/docs/api/models/PartialApprovalDisposition.md)): Where the partial approval currently sits in its decision lifecycle.  `null` is equivalent to `Pending`:  the shape a document written by the detection step alone can take. (nullable)
  Values:
  - `Pending`: The partial approval has been detected and recorded, but nobody has decided its fate yet. The transaction is holding a reduced authorization at the issuer and is waiting on an operator/cardholder acknowledgment until dispositionDeadlineUtc elapses.
  - `Accepted`: The reduced authorization was accepted as-is. No reversal is issued and the transaction proceeds through the normal capture/settlement path for the approved (lesser) amount.
  - `Voided`: The reduced authorization was rejected and reversed, so the issuer hold is released. The reason is recorded on voidReason (operator choice, acknowledgment timeout, or an automatic gateway policy void).
  - `SplitTenderInitiated`: The reduced authorization was kept and a follow-up tender was started to collect the shortfall. The continuation transaction carries the same SplitTenderGroupId with the next SplitTenderSequence.
- `dispositionSetAtUtc` (string(date-time)): UTC timestamp of the moment `disposition` last moved. Set alongside every  disposition write, including the initial transition to  `Pending` at detection time, so the age of a stuck  pending disposition is measurable. (nullable)
- `dispositionDeadlineUtc` (string(date-time)): UTC instant by which a `Pending` disposition must be  resolved before the gateway voids the reduced authorization on the operator's behalf. (nullable)
- `voidReason` (string): Why the reduced authorization was voided, for the merchant audit trail. Only meaningful  when `disposition` is `Voided`;  `null` otherwise. (nullable)
- `requestedAmount` (number(double)): The amount the gateway asked the issuer to authorize, in major currency units, snapshotted  at detection time. Kept here rather than read back from the response because a subsequent  reversal overwrites `/ResponseData`. (nullable)
- `approvedAmount` (number(double)): The lesser amount the issuer actually authorized, in major currency units, snapshotted at  detection time. The shortfall a split tender needs to collect is  `requestedAmount` minus this value. (nullable)

## See also

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