# BillingPriceOverrides

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

## Fields
- `fees` (object): (nullable)
- `feesJson` (string): (nullable)
- `customFees` (array<[CustomFeeDefinition](https://devportal.demo.winkpg.io/docs/api/models/CustomFeeDefinition.md)>): (nullable)
  Fields of each item:
  - `label` (string): Display label for the fee (shown in UI and reports). (nullable)
  - `code` (string): Internal code for programmatic or accounting reference. (nullable)
  - `chargeType` ([ChargeType](https://devportal.demo.winkpg.io/docs/api/models/ChargeType.md)): Classification of the charge (e.g. platform fee, merchant product, tax, discount).
    Values:
    - `PlatformFee`
    - `MerchantFee`
    - `Tax`
    - `Discount`
    - `Adjustment`
  - `frequency` ([FeeFrequency](https://devportal.demo.winkpg.io/docs/api/models/FeeFrequency.md)): Indicates billing frequency (one-time, recurring, per-transaction, etc.).
    Values:
    - `OneTime`
    - `Recurring`
    - `PerTransaction`
    - `Annual`
    - `Custom`
  - `period` ([BillingPeriod](https://devportal.demo.winkpg.io/docs/api/models/BillingPeriod.md)): Defines the billing period interval (e.g. every 1 month, every 3 months).
  - `category` (string): Category for grouping related fees (e.g. Add-Ons, Fraud Tools). (nullable)
  - `strategy` ([BillingPricingStrategy](https://devportal.demo.winkpg.io/docs/api/models/BillingPricingStrategy.md)): Pricing model for this fee (fixed, percentage, or tiered).
    Values:
    - `Fixed`
    - `Percentage`
    - `Tiered`
  - `percentageRate` (number(double)): The percentage rate (used when Strategy = Percentage). (nullable)
  - `tiers` (array<[TierDefinition](https://devportal.demo.winkpg.io/docs/api/models/TierDefinition.md)>): Tier definitions (used when Strategy = Tiered). (nullable)
  - `amounts` ([FeePair](https://devportal.demo.winkpg.io/docs/api/models/FeePair.md)): The buy/sell values for this fee (used when Strategy = Fixed).
  - `currency` (string): Currency for this fee (overrides plan-level currency if set). (nullable)
  - `taxCode` (string): Optional tax code for integration with tax engines or accounting systems. (nullable)
  - `showOnInvoice` (boolean): Determines whether this item should be visible on customer invoices.
  - `isActive` (boolean): Indicates if this fee is currently active.
  - `metadata` (object): Arbitrary metadata for extensibility (e.g., tax region, GL mapping, reseller visibility). (nullable)

## See also

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