> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tonder.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Business Configuration

> Sets the default UI configuration (logo and styles) for all your Hosted Checkout sessions.
This configuration will be applied to all payment sessions unless overridden at the session level.


Use this endpoint to configure your default branding and UI settings for all Hosted Checkout sessions. Once set, these defaults will apply to every new payment session unless you override them at the session level.

## When to Use This

Call this endpoint once during your initial setup or whenever you want to update your default checkout appearance. This is particularly useful for:

* Setting up your brand colors and logo across all checkout sessions.
* Maintaining a consistent checkout experience for all customers.
* Updating your branding without modifying individual session creation calls.

## Related Resources

* [How to Customize the Checkout UI](/hosted-checkout/guides/customize-checkout-ui): Learn how to use this endpoint in practice.
* [UI Configuration Fields](/hosted-checkout/reference/ui-configuration-fields): Complete reference of all customization options.


## OpenAPI

````yaml POST /checkout/v1/business/config
openapi: 3.0.3
info:
  title: Tonder
  description: Tonder API
  termsOfService: https://www.google.com/policies/terms/
  contact:
    email: hello@tonder.io
  version: v1
servers:
  - url: https://api-stage.tonder.io/api/v1
    description: Staging
  - url: https://api.tonder.io/api/v1
    description: Production
security: []
paths:
  /checkout/v1/business/config:
    post:
      tags:
        - Hosted Checkout
      summary: Set Business Configuration
      description: >
        Sets the default UI configuration (logo and styles) for all your Hosted
        Checkout sessions.

        This configuration will be applied to all payment sessions unless
        overridden at the session level.
      operationId: setBusinessConfig
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                logo_url:
                  type: string
                  format: uri
                  description: A publicly accessible URL for your business logo
                  example: https://cdn.my-store.com/logo.png
                ui_config:
                  $ref: '#/components/schemas/UIConfig'
            example:
              logo_url: https://cdn.my-store.com/logo.png
              ui_config:
                branding:
                  brand_color: '#1A2B3C'
                theme:
                  shapes: rounded
      responses:
        '200':
          description: Configuration saved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  logo_url:
                    type: string
                    format: uri
                  ui_config:
                    $ref: '#/components/schemas/UIConfig'
              example:
                logo_url: https://cdn.my-store.com/logo.png
                ui_config:
                  branding:
                    brand_color: '#1A2B3C'
                  theme:
                    shapes: rounded
      security:
        - Authorization: []
components:
  schemas:
    UIConfig:
      type: object
      description: UI configuration for Hosted Checkout customization
      properties:
        branding:
          type: object
          properties:
            brand_color:
              type: string
              pattern: ^#[0-9A-Fa-f]{6}$
              description: Primary brand color (hex code)
              example: '#1A2B3C'
        theme:
          type: object
          properties:
            shapes:
              type: string
              enum:
                - rounded
                - square
              description: Shape style for UI elements
              example: rounded
  securitySchemes:
    Authorization:
      type: apiKey
      name: Authorization
      in: header

````