# MerchantBranding

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

Represents merchant-level branding configuration used for receipts and customer-facing communications.

## Fields
- `logo` (string): Storage path to the merchant's logo image. The server resolves it to an absolute URL when it  renders a receipt or other customer-facing content. (nullable, min length 0, max length 500)
- `brandColor` (string): Hex color code used as the brand accent on receipts and customer-facing communications (e.g. "#1a1a1a"). (nullable, min length 0, max length 9)
- `supportPhone` (string): Support phone number displayed on receipts. Overrides `phone` when present. (nullable, min length 0, max length 20)
- `supportEmail` (string): Support email address displayed on receipts. Overrides `emailAddress` when present. (nullable, min length 0, max length 100)
- `receiptFooterText` (string): Free-text footer message printed at the bottom of receipts (e.g. "Thank you for your business!"). (nullable, min length 0, max length 500)
- `displayAddress` ([Address](https://devportal.demo.winkpg.io/docs/api/models/Address.md)): Display address shown on receipts. When null, falls back to the first address in `addresses`.
  Fields:
  - `id` (string(uuid)): Gets the unique identifier for the address. (read only)
  - `address1` (string): Gets or sets the first line of the address (e.g., street address). (nullable, max length 100)
  - `address2` (string): Gets or sets the second line of the address (e.g., apartment, suite, unit, building, floor, etc.). (nullable, max length 100)
  - `city` (string): Gets or sets the city of the address. (nullable, max length 100)
  - `state` (string): Gets or sets the state or region of the address. (nullable, max length 100)
  - `province` (string): Gets or sets the province of the address (if applicable). (nullable)
  - `zip` (string): Gets or sets the ZIP code of the address. Conditional: Conditional (see validator source). Pattern: ^\d{5}(-\d{4})?$. Conditional: When IsUsCountry(Country) is false. Max length: 20. (nullable)
  - `postalCode` (string): Gets or sets the postal code of the address. (nullable, max length 20)
  - `country` (string): Gets or sets the country of the address. Defaults to "USA". (nullable, max length 100)
  - `isMailing` (boolean): Gets or sets a value indicating whether this address is a mailing address.
  - `isDefault` (boolean): Gets or sets a value indicating whether this address is the default address.
- `termsAndConditions` (string): Terms and conditions of sale displayed on receipts (e.g. "No Refunds").  Required by Fiserv receipt compliance when the merchant has conditions of sale. (nullable, min length 0, max length 500)

## See also

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