Core Principle
三端協作 · 權限邊界清晰
代理 Portal 僅展示分成與結算，不代商戶操作出款、換匯、KYB。設計上就不允許代理觸碰商戶資金——保障合規與客戶信任。
在平台 ↔ 商戶之上，新增渠道與分潤層
渠道代理用邀請碼拓客賺價差；商戶代理從服務商戶的手續費中按比例分成。Admin 配置放/不放佣金、單層或多層架構，代理 Portal 只看分成數據，不代操商戶資金。
三端分工與分成觸發路徑（放佣金模式）
Admin 後台
合規 · 營運 · 配置- 建立代理檔案（渠道 / 商戶代理）
- 設定佣金開關（放 / 不放）
- 配置底價、價差 SPREAD、分成比例
- 指派渠道代理 · 審批月結批次
- 折算多幣種 → 結算幣審批
↓ 輸出：代理方案、費率規則、月結指令
AnyPay 核心
交易 · 記帳 · 風控- 處理收款 / 出款 / 收卡交易
- 計算 merchantFee（依商戶費率方案）
- 匹配綁定：渠道 + 商戶代理
- 寫入 ACCRUED 分成流水
- 幂等鍵 (txnId, agentId, agentKind)
↔ 接收交易事件 · 輸出分成流水
代理 Portal
只讀分成 · 不可代操- 查看 ACCRUED / SETTLED / REVERSED
- 下級商戶 KYB 狀態 · 累計分成
- 邀請碼 · 商戶成長漏斗（渠道）
- 代理錢包餘額 · 發起提領
- 月結批次詳情 · 對帳單導出
↑ 只讀分成數據 · 不可見商戶餘額
商戶門戶
日常業務 · 綁定代理- 發起收款 / 出款 / 換匯 / 收卡
- 註冊時填渠道邀請碼（限一次）
- 設定頁綁定商戶代理（邀請碼 + 支付密碼）
- 查看渠道代理（只讀，不展示返佣比例）
- 平台商：子商戶 Unit 交易歸主 merchantId
→ 輸出：交易事件 + merchantFee
Admin 配置方案→
平台依規則記帳→
代理 Portal 只讀
|
商戶發起交易→
平台計算 merchantFee
一筆出款如何觸發分成（具體路徑）
1
商戶發起出款
USD 100,000
費率 0.50%
payout.completed
2
計算手續費
merchantFee
= USD 500
3
匹配綁定
渠道 SPREAD 0.20%
商戶代理 40% of fee
4
寫入流水
2 條 ACCRUED
（可並存）
ACCRUED
5
Admin 月結
折算 · 審批
≥ USD 100 門檻
SETTLED
6
代理提領
入代理錢包
綁定帳戶提領
代理不可代商戶出款
代理不可見商戶 API Secret
代理不可見商戶交易明細
綁定變更不追溯歷史
核心鐵律：
① 同一商戶最多 1 渠道代理 + 1 商戶代理，可並存；
② 綁定變更不追溯歷史；
③ 矩陣子商戶（Unit）交易仍歸主 merchantId 計算分成；
④ 同一筆交易可分別產生兩條分成流水（渠道 + 商戶代理）；
⑤ 幂等鍵 (txnId, agentId, agentKind) 防重複記帳。