Skip to main content
POST
/
checkout
/
v1
/
business
/
config
Set Business Configuration
curl --request POST \
  --url https://api-stage.tonder.io/api/v1/checkout/v1/business/config \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "logo_url": "https://cdn.my-store.com/logo.png",
  "ui_config": {
    "branding": {
      "brand_color": "#1A2B3C"
    },
    "theme": {
      "shapes": "rounded"
    }
  }
}
'
{
  "logo_url": "https://cdn.my-store.com/logo.png",
  "ui_config": {
    "branding": {
      "brand_color": "#1A2B3C"
    },
    "theme": {
      "shapes": "rounded"
    }
  }
}
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.

Authorizations

​
Authorization
string
header
required

Body

application/json
​
logo_url
string<uri>

A publicly accessible URL for your business logo

Example:

"https://cdn.my-store.com/logo.png"

​
ui_config
object

UI configuration for Hosted Checkout customization

Response

200 - application/json

Configuration saved successfully

​
logo_url
string<uri>
​
ui_config
object

UI configuration for Hosted Checkout customization