# SurchargeStatePolicyDto

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

Data-transfer representation of a per-state surcharge policy embedded in a merchant's
configuration. Expresses how a US state restricts surcharging and, where the state imposes a
numeric ceiling, the cap itself. Rates are decimal fractions (0.02 = 2%).

## Fields
- `stateCode` (string) required: Two-letter US state code (e.g. "CO", "NY"). (nullable)
- `restrictionType` ([SurchargeStateRestrictionType](https://devportal.demo.winkpg.io/docs/api/models/SurchargeStateRestrictionType.md)) required: How the state restricts surcharging. (nullable)
  Values:
  - `Prohibited`: Surcharging is prohibited outright in the state.
  - `Restricted`: Surcharging is allowed but constrained (e.g. a state cap or disclosure rules).
  - `Permissive`: Surcharging is permitted with no state-specific restriction beyond network rules.
- `capRate` (number(double)): Optional state-imposed maximum rate (decimal fraction). Null means the state applies no numeric  cap beyond network rules. Conditional: When CapRate is not null. Must be >= 0. (nullable)

## See also

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