# SurchargeQuoteResultDto

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

The result of a surcharge-eligibility quote. A PCI-safe response carrying the eligibility verdict,
the resolved rate and computed amount, the total including the surcharge, the ineligibility reason
code when not eligible, and the disclosure copy the integrator renders verbatim (the merchant's own
wording when they have configured any, otherwise the platform default).

## Fields
- `eligible` (boolean): Whether the transaction may be surcharged.
- `surchargeRate` (number(double)): The applied surcharge rate as a decimal fraction (0.03 = 3%); null when ineligible. (nullable)
- `surchargeAmount` (number(double)): The computed surcharge amount, in the transaction currency; null when ineligible. (nullable)
- `baseAmount` (number(double)): The base transaction amount the quote was computed against, in the transaction currency.
- `totalWithSurcharge` (number(double)): The base amount plus the computed surcharge, in the transaction currency; equals  `baseAmount` when ineligible.
- `ineligibilityReason` (string): The ineligibility reason code (the `SurchargeIneligibilityReason` name, e.g.  DebitCard, NonUsIssuedCard), or null when eligible. (nullable)
- `requiresDisclosure` (boolean): Whether the caller must present a surcharge disclosure to the cardholder before payment.
- `disclosureText` (string): The ready-to-render disclosure text (rate stated plus the does-not-exceed-cost-of-acceptance  statement), matching what the Virtual Terminal and Hosted Payment Page show the same cardholder.  Non-null only when `eligible` is true. (nullable)

## See also

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