白标商户接入完整教程

1️⃣ 主色（最重要的一个）

你设的主色会自动渗透到整站所有按钮、链接、强调色、Logo 主色、邮件按钮 — 一次设置全套换肤。7 个常用预设：

2️⃣ 布局风格

你的客户登录后看到的 dashboard 结构。Sidebar 适合功能多的产品，Topbar 更简洁。

3️⃣ 字体

4️⃣ 按钮形状 + 样式

5️⃣ 实时预览编辑器

真实的 /brand 后台：左侧编辑、右侧同步预览。下方是带 sidebar 的完整后台界面：

📸 自动版本快照 + 回滚

每次保存改动前，系统自动给当前配置拍快照。最多保存最近 10 版。一键回滚到任意版本。

三层价格模型

每次客户调用 API，系统按这三步分账：

/pricing 页面真实界面

按厂商分 tab（Anthropic / OpenAI / Aliyun / DeepSeek / AWS Bedrock）。每行对比 EastX 批发价 vs 你的零售价 vs 毛利率：

3 种常见定价策略

返佣作用范围

返佣是 EastX 平台的原生功能，每个租户都可以独立启用 / 关闭、独立设比例。平台租户 (id=1) 用默认比例 L1=5% / L2=2%；每个白标商户都可以在自己的商户后台单独配置。

3 种典型配置

怎么改

商户后台 /brand 页面的"返佣"段，或通过商户管理 API 改：

# 关闭你这个租户内所有返佣
curl -X PATCH https://api.eastx.ai/api/v1/merchant/me \
  -H "Authorization: Bearer sk-mgmt-acme-XXX" \
  -H "Content-Type: application/json" \
  -d '{"referralEnabled": false}'

# 自定义比例（L1=8%, L2=3%）
curl -X PATCH https://api.eastx.ai/api/v1/merchant/me \
  -H "Authorization: Bearer sk-mgmt-acme-XXX" \
  -H "Content-Type: application/json" \
  -d '{"referralL1Pct": 8, "referralL2Pct": 3, "referralEnabled": true}'

# 改回跟随平台默认
curl -X PATCH https://api.eastx.ai/api/v1/merchant/me \
  -H "Authorization: Bearer sk-mgmt-acme-XXX" \
  -H "Content-Type: application/json" \
  -d '{"referralL1Pct": null, "referralL2Pct": null}'

客户访问子域 → 充值页 → 入账 → 你看到 deposit

下面 4 个状态自动循环演示，配色用你的品牌色：

DNS 配置示例

# 在你的域名服务商那里加一条 DNS 记录：

类型    名字           值
CNAME   ai             portal.eastx.ai
# 或
A       ai             47.237.223.35    （portal 入口 IP，会随基础设施调整）

/domains 真实界面

三种状态：✓ Active / ⏳ Verifying / ✗ Failed：

公式（每月 1 号 cron 自动算）

endUserDepositsUsd = SUM(orders.amount_usd) [当月、tenant=你、status=confirmed]
upstreamCostUsd    = SUM(usage_records.upstream_cost_usd) [当月、tenant=你]
grossMarginUsd     = endUserDepositsUsd - upstreamCostUsd

# 平台按毛利百分比抽成，具体 platformCutPct 由合作协议约定
platformCutUsd     = max(0, grossMarginUsd × platformCutPct)

# 剩下的就是该汇给你的钱
merchantPayableUsd = max(0, grossMarginUsd - platformCutUsd)

# 如果毛利为负（罕见），平台不倒扣商户

/my-settlements 真实列表界面

商户在自己后台看到的历史结算列表：

单条结算单展开看

点开一条 settlement 看到的详情卡片：

三方角色 · 谁做什么