跳转到主要内容

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.

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 集成

相关页面

Last modified on May 15, 2026