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

# 品牌设置

> 在 StablePay Portal 中上传商家 logo 并设置品牌颜色，将品牌元素应用到 StablePay 托管客户页面。

Branding Settings 允许商家在 StablePay Portal 中统一配置自己的基础品牌元素，并将这些设置应用到 StablePay 托管的客户可见页面中。

这项能力适合希望让客户在支付、查看账单或接收相关通知时，更清楚地感知商家品牌的场景。它可以帮助提升页面一致性、信任感和整体品牌体验，而不需要商家自行改造托管支付页面。

## 可配置内容

当前商家可以在 Portal 中配置：

* `Logo`：用于展示商家完整品牌标识
* `Background`：用于大面积品牌背景区域
* `Button`：用于主要按钮和主 CTA 颜色

这些设置会先在 preview 中展示效果，只有点击 `Save changes` 后才会正式生效。

## 会应用到哪些页面

Branding Settings 会应用到 StablePay 托管的客户可见页面，包括：

* Stablecoin Checkout
* Payment Links pay page
* Subscription checkout
* Hosted Invoice Payment Page
* Invoice PDF
* 客户可见的相关邮件触点

如果你的业务同时使用 Checkout、Payment Links 和 Invoicing，这个设置可以帮助这些客户界面保持统一的品牌感。

## 如何使用

1. 在 StablePay Portal 中进入 `Settings`
2. 打开 `Branding`
3. 上传商家 logo
4. 设置背景色和按钮色
5. 在 preview 中查看 Desktop / Mobile 或 Invoice 效果
6. 点击 `Save changes` 正式发布

## 设计与回退逻辑

* 如果未上传 logo，系统会使用默认占位逻辑
* 如果未设置背景色，页面回退到 StablePay 默认背景色 `#635BFF`
* 如果未设置按钮色，页面回退到 StablePay 默认按钮色 `#2452F8`
* 如果配置异常或资源加载失败，托管页面会自动回退到默认样式，不阻塞客户打开页面

## 上传与配置建议

* Logo 建议使用清晰的 PNG 或 JPG
* 最小尺寸建议为 `128 × 128 px`
* 文件大小建议控制在 `512 KB` 以内
* 背景色和按钮色建议与品牌主色保持一致，但同时保证按钮文字和页面内容的可读性

## 适合什么时候设置

建议在正式上线前完成 Branding Settings，尤其是在以下场景：

* 你要让 Hosted Checkout 更像自己的品牌页面
* 你会向客户发送 invoice、invoice PDF 或 payment links
* 你希望不同托管页面和邮件中的品牌感保持一致

## 重要说明

* 本期提供的是基础品牌元素配置，不是完整主题系统
* 当前不支持自定义字体、布局、圆角、文案或页面级单独覆盖
* Branding Settings 通过 Portal 配置，不需要 API 集成

## 相关页面

* [开始使用](/zh/product/Get-Started)
* [稳定币收银台](/zh/product/Stablecoin-Checkout)
* [支付链接](/zh/product/Payment-Links)
* [账单收款](/zh/product/Invoicing)
* [收银台展示与 Logo 规范](/zh/product/Checkout-Display-Guide--StablePay-Logo)