# OrderDataDefaultSettingsDto

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

DTO for merchant self-service order data defaults operations.
Wraps the shared `OrderDataDefaultSettings` with a concurrency stamp
for optimistic concurrency on save.

## Fields
- `settings` ([OrderDataDefaultSettings](https://devportal.demo.winkpg.io/docs/api/models/OrderDataDefaultSettings.md)): The order data default settings values.
  Fields:
  - `enable` (boolean)
  - `applyLevel2DefaultsToApi` (boolean)
  - `applyLevel3DefaultsToApi` (boolean)
  - `applyLevel2DefaultsToVt` (boolean)
  - `applyLevel3DefaultsToVt` (boolean)
  - `applyLevel2DefaultsToHpp` (boolean): Whether Level 2 defaults apply to Hosted Payment Page transactions.  `null` means "follow `applyLevel2DefaultsToApi`", which is the behaviour every  merchant document written before this toggle existed already had: hosted page transactions were  bucketed under the API toggle. (nullable)
  - `applyLevel3DefaultsToHpp` (boolean): Whether Level 3 defaults apply to Hosted Payment Page transactions.  `null` means "follow `applyLevel3DefaultsToApi`". See  `applyLevel2DefaultsToHpp` for why. (nullable)
  - `defaultMerchantZip` (string): Default merchant zip code for L2 enhanced data. When set, takes priority over the merchant's contact address zip. (nullable, max length 10)
  - `defaultTaxRate` (number(double)): Default tax rate for L2/L3 enhanced data. Takes priority over the VT tax field's default rate.  Expressed as a percentage (e.g., 8.25 for 8.25%) or as a decimal (e.g., 0.0825). (nullable, min 0)
  - `defaultShipFromZip` (string): Default ship-from zip code for L3 enhanced data. When set, takes priority over the merchant's contact address zip. (nullable, max length 10)
  - `defaultDestinationCountryCode` (string): Default destination country code for L3 enhanced data (ISO 3166-1 alpha-3, e.g., "USA"). (nullable, max length 3)
  - `defaultDutyAmount` (number(double)): Default duty amount for L3 enhanced data. Set to 0.00 for domestic-only merchants. (nullable, min 0)
  - `defaultFreightAmount` (number(double)): Default freight/shipping amount for L3 enhanced data. (nullable, min 0)
  - `defaultDiscountAmount` (number(double)): Default header-level discount amount for L3 enhanced data. (nullable, min 0)
  - `defaultLineItemValues` ([LineItemDefaults](https://devportal.demo.winkpg.io/docs/api/models/LineItemDefaults.md)): Default field values applied to every new line item added in the Virtual Terminal. Conditional: When DefaultLineItemValues is not null.
  - `defaultLineItem` ([Level3LineItem](https://devportal.demo.winkpg.io/docs/api/models/Level3LineItem.md)): A template line item that auto-populates as the first line item on new transactions.  Useful for single-product merchants (parking, subscriptions, recurring services).  When null, no template line item is added.
- `concurrencyStamp` (string): Concurrency stamp for optimistic concurrency control. (nullable)
- `isFeatureEnabled` (boolean): Whether the `AllowOrderDataDefaultsConfig` feature is enabled for this merchant.  Read-only: set by the server, ignored on update.
- `virtualTerminalFields` ([VirtualTerminalFields](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalFields.md)): The merchant's Virtual Terminal field configuration at the time of load.  Used by the UI to enforce cross-field constraints (e.g. a default tax rate  requires `taxAmount` to be enabled).  Read-only: set by the server, ignored on update.
  Fields:
  - `customer` ([VirtualTerminalCustomerField](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalCustomerField.md))
  - `invoiceNumber` ([VirtualTerminalInvoiceNumField](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalInvoiceNumField.md))
  - `purchaseOrderNumber` ([VirtualTerminalPurchaseOrderNumField](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalPurchaseOrderNumField.md))
  - `billingAddress` ([VirtualTerminalBillingAddressFieldGroup](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalBillingAddressFieldGroup.md))
  - `shippingAddress` ([VirtualTerminalShippingAddressFieldGroup](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalShippingAddressFieldGroup.md))
  - `contactPhone` ([VirtualTerminalPhoneField](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalPhoneField.md))
  - `level3Amount` ([VirtualTerminalLevel3AmountField](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalLevel3AmountField.md))
  - `shippingAmount` ([VirtualTerminalShippingAmountField](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalShippingAmountField.md))
  - `convenienceAmount` ([VirtualTerminalConvenienceFeeField](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalConvenienceFeeField.md))
  - `dutyAmount` ([VirtualTerminalDutyAmountField](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalDutyAmountField.md))
  - `tipAmount` ([VirtualTerminalTipAmountField](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalTipAmountField.md))
  - `taxAmount` ([VirtualTerminalTaxField](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalTaxField.md))
  - `emailAddress` ([VirtualTerminalEmailField](https://devportal.demo.winkpg.io/docs/api/models/VirtualTerminalEmailField.md))

## See also

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