Complete white-label merchant onboarding guide

1️⃣ Primary color (the single most important setting)

Your primary color cascades through every button, link, accent, logo accent, and email button site-wide — one setting, full reskin. 7 common presets:

2️⃣ Layout style

The dashboard structure your customers see after login. Sidebar suits feature-rich products; topbar is more minimal.

3️⃣ Font

4️⃣ Button shape + style

5️⃣ Live preview editor

The real /brand console: edit on the left, preview synced on the right. Below is the full console with sidebar:

📸 Auto version snapshots + rollback

Before every save, the system snapshots the current config. Up to 10 most recent versions kept. One-click rollback to any version.

Three-tier pricing model

Every customer API call splits across these three steps:

Real /pricing page UI

Tabbed by vendor (Anthropic / OpenAI / Aliyun / DeepSeek / AWS Bedrock). Each row compares EastX wholesale vs your retail vs gross margin:

3 common pricing strategies

Referral scope

Referral commissions are an EastX native feature. Every tenant can enable / disable and set rates independently. The platform tenant (id=1) uses default L1=5% / L2=2%; every white-label merchant can configure its own in the merchant console.

3 typical configurations

How to change it

In the merchant console /brand page under the "Referral" section, or via the merchant management API:

# Disable referral commissions for your tenant
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}'

# Custom rates (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}'

# Switch back to platform default
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}'

Customer hits subdomain → top-up page → credited → you see deposit

The 4 states below cycle automatically, all rendered in your brand color:

DNS config example

# Add a DNS record at your domain registrar:

Type    Name           Value
CNAME   ai             portal.eastx.ai
# or
A       ai             47.237.223.35    (portal entry IP, may change with infra)

Real /domains UI

Three states: ✓ Active / ⏳ Verifying / ✗ Failed:

Formula (cron runs automatically on the 1st)

endUserDepositsUsd = SUM(orders.amount_usd) [this month, tenant=you, status=confirmed]
upstreamCostUsd    = SUM(usage_records.upstream_cost_usd) [this month, tenant=you]
grossMarginUsd     = endUserDepositsUsd - upstreamCostUsd

# Platform takes a percentage of gross margin; platformCutPct is set in your partnership agreement
platformCutUsd     = max(0, grossMarginUsd × platformCutPct)

# The remainder is what we pay out to you
merchantPayableUsd = max(0, grossMarginUsd - platformCutUsd)

# If gross margin is negative (rare), the platform does not claw back from the merchant

Real /my-settlements list UI

The historical settlement list as merchants see it in the console:

Single settlement, expanded

The detail card you see when opening one settlement:

Three roles · who does what