---
title: "Set Business Configuration"
method: POST
path: "/checkout/v1/business/config"
tags: ["Hosted Checkout"]
---

# Set Business Configuration

`POST /checkout/v1/business/config`

## Request

- Base URL: `https://api-stage.tonder.io/api/v1`
- URL: `https://api-stage.tonder.io/api/v1/checkout/v1/business/config`
- Auth: API key in header `Authorization`

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.

## Request body

- object
  - `logo_url` string, uri: A publicly accessible URL for your business logo
  - `ui_config` UIConfig: UI configuration for Hosted Checkout customization
    - `branding` object
      - `brand_color` string: Primary brand color (hex code)
    - `theme` object
      - `shapes` 'rounded' | 'square': Shape style for UI elements

## Response `200`

Configuration saved successfully

- object
  - `logo_url` string, uri
  - `ui_config` UIConfig: UI configuration for Hosted Checkout customization
    - `branding` object
      - `brand_color` string: Primary brand color (hex code)
    - `theme` object
      - `shapes` 'rounded' | 'square': Shape style for UI elements

## Changes

- **2025-11-20** `7dc2967e7dd5`: 2 info
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
- **2025-11-04** `37bf0f336bc8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tonderio/apis/tonder/changes/checkout/v1/business/config/post.md)

---

[API](https://skmtc.dev/tonderio/apis/tonder.md) - [All operations](https://skmtc.dev/tonderio/apis/tonder/llms.txt) - [OpenAPI document](https://skmtc.dev/tonderio/apis/tonder/revisions/aface34fb9b2?raw)
