將合作夥伴整合到生態系統中

1）角色和參與模式

運營商/品牌：店面,結算,KYC/AML,用戶體驗責任。
工作室/RGS/內容聚合器：遊戲/流媒體，目錄，促銷工具。
支付提供商/錢包：PSP，APM，加密，charjbacks。
KYC/AML/Antifrod：驗證，雪橇清單，風險評分。
會員/營銷網絡：流量、後退、歸屬。
ISV/集成商：附加模塊,市場應用。

型號： referral/resell, white-label/OEM, marketplace/app-store, hub&spoke（聯邦）.

2）「合作夥伴護照」和啟動包

為什麼：關於權利、區域、版本、SLO、密鑰和過程的單一真相來源。

yaml partner_passport. v1:
partner_id: "kyc-omega"
type: "KYC/AML"
regions: ["EU","TR","LATAM"]
contracts: { msa: "2025-01-10", dpa: "2025-01-10", sla: "99. 9/30d" }
api_versions: ["identity. v1","events. v1","webhook. v1"]
auth: { oidc_client_id: "p_omega", scopes: ["kyc:read","kyc:write"] }
webhooks: { signature: "Ed25519", retry: "exp", dedupe: true, ttl_s: 300 }
rate_limits: { rps: 100, burst: 300 }
pii_policy: { minimization: true, retention: "180d", geo_pinning: ["EU"] }
recon: { window_days: 7, epsilon: 0. 002 }
owners: { biz: "ecosystem-biz", tech: "integrations" }
status: "sandbox"

3）登陸： 從申請到生產的過程"

1.篩選：問卷，合作夥伴的KYC，數據/流量來源，雪橇支票。
2.條約：MSA/DPA/SLA/OLA，商業（CPA/RevShare/Hybrid/net basis）。
3.啟動：發出OIDC鑰匙/客戶端,訪問沙箱,測試套件。
4.配對測試：事件模式，webhooks，限制，等效性。
5.安全性審查：工件簽名,SBOM/SLSA（如果SDK/客戶端）。
6.飛行員/金絲雀：數量有限/地理，監測得到加強。
7.直播：狀態翻譯，SLO-dashbords，響應計劃。
8.QBR/MBR：KPI定期審查，事件，路線圖。

4）數據合同和事件模式

原則：最小化，版本（semver），「vN/vN+1」兼容性，簽名。

yaml event. common. v1:
id: uuid occurred_at_utc: timestamp source_partner_id: string trace_id: uuid type: enum        # e. g., "kyc. approved. v1"
payload: object signature: ed25519 version: "1. 0. x"

目錄和報告：JSON 計劃/Avro，強制性字段控制，TTL/還原，法律保留。
穩定性：僅通過帶有deprecation窗口的新類型/版本進行突破性更改。

5）身份驗證、授權、秘密

OAuth2/OIDC：短壽命令牌，PoP/DPoP。
服務器服務器的mTLS。
簽名的webhooks：Ed25519/HMAC；反重播（「X-Timestamp」，窗口5分鐘）。
PoLP/ABAC：漏洞/屬性：「合作夥伴」，「地區」，「數據」，「env」。
關鍵輪換：雙向的，具有兼容性窗口和審計日誌。

python def verify(req):
if abs(now()-req. h["X-Timestamp"])>300: return 401 if not sig_ok(req. body, req. h["X-Signature"], partner_pubkey): return 401 if seen(req. json["event_id"]): return 200 store(req. json); mark_seen(req. json["event_id"]); return 200

6）相等性，限制，可持續性

Idempotency-Key: `partner_id + external_id + op_type`.

價格限制/quotas：RPS，爆發，「溫暖起步」，降解時降低系數。
Retry Policy：參展商+jitter，招待會上的惡作劇。
Outbox/inbox模式：有保證的交付、去除、審核。
Backpressure：隊列,DLQ帶有單獨的還原。

7）可觀察性和SLO

Метки: `partner`, `region`, `api_version`, `route`, `env`.

SLI：可用性,p95/99 latency, error-rate, delivere-within-windows, recon-diff。
SLO&burn rate：每個合作夥伴/節點；超出。
跟蹤：端到端「trace_id」；尾巴和錯誤采樣（尾巴采樣）。
合成：外部末端/簽名/TTL檢查。

rego package partner. release deny["SLO at risk"] { input. slo_forecast. error_burn > 1. 0 }
deny["Missing schema tests"] { input. tests. schemas_passed == false }

8）合規與隱私

Geo-pinning：敏感域的數據不會離開允許的區域。
PII最小化和別名：「user_pseudo_id」代替直接PD。
保留時間：TTL/ILM；按鍵（per 合作夥伴/per區域）加密。
主體權利：將DSAR路由到源，執行日誌。
訪問日誌和審計：誰看到，何時，為什麼；不變的邏輯。

9）計算，歸因和重新計算

計算基礎：net vs gross，貨幣匯率，稅收，獎金。
歸因：窗口（click/view）,通道優先級,「event_id/click_id」的去除。
Reconciliation：雙邊報告,ε-dopusk, SLA關閉差異（≤5 r.d.）。

sql
SELECT a. event_id
FROM partner_report a
LEFT JOIN internal_events b ON a. event_id=b. event_id
WHERE a. date BETWEEN:from AND:to AND b. event_id IS NULL;

10） API驗證和變更管理

Semver：「v1」是穩定的分支；breaking → 'v2'，雙重支持≥90天。
脫落過程：在護照上宣布→旗幟→ 合成/alerta →關閉。
SDK/連接器：版本簽名,SBOM,兼容性,遷移粘合劑。

11）路由和聯盟（如果具有相同類型的多個合作夥伴）

SOR（智能訂單路由）：價格/質量/潛在性/合規性/聲譽。

公平： 營業額份額限制,SLA/聲譽決勝局.

降級：誠實的倒退，透明的惡化（通知/橫幅）。

12）事件花花公子

12.1「韋布胡克計劃的拖曳」

yaml detect: "schema_validation_error_rate>0. 5%"
steps:
- "auto-pause partner webhooks"
- "fallback to cached/default behavior"
- "notify partner; open war-room"
- "provide diff & test vectors; hotfix window 24h"
kpi: ["RTA<=1h","residual_errors<0. 1%"]

12.2 「PSP/KYC的SLO失敗」

1.通過SOR重新分配→

2.在線程中啟用graceful-degradation →

3.應用限制/配額→

4.獲得SLA和事後貸款。

12.3「計算中的差異」

1.Freeze →範圍付款

2.從outbox重新驅動事件→

3.匹配/ε校正→

4.聯合行動和解凍。

13）市場/合作夥伴門戶

集成認證：支票單，質量徽章（黃金/銀/青銅）。
連接器目錄：按市場/類型/API版本搜索/過濾器。
Autogen-SDK/spack： OpenAPI/AsyncAPI,示例,Postman集合。
自助服務：密鑰、webhooks、限制、日誌、測試框架。

14）積分成熟度度量

時間到集成（TTI）： prod之前的天數中位數。
Coverage：合作夥伴支持的市場/功能份額。
SLO通行率：按合作夥伴/地區每月。
Recon-Health：差額關閉率，殘余ε。
安全帖子：按鍵輪換頻率，SBOM覆蓋。
Cost/egress： $/req和$/GB合作夥伴,SOR效率。

15）反模式

「我們首先連接，然後標準」→動物園集成。
每個合作夥伴的獨特方案→復雜性的爆炸。
只有cookie歸屬而沒有S2S →損失和爭議。
沒有等效性/限制→復制/風暴後退。
Logs/webhoos中的PII →監管風險。
一個沒有替代品的「超級集成」→集中風險。
在銷售中發生事故→,不帶脫印窗口和合成材料的API更改。

16）集成架構師支票清單

1.合作夥伴護照已滿（合同、地區、版本、密鑰、SLO）?

2.事件圖和報告由測試包驗證，有沙箱嗎？
3.OAuth/OIDC、授權的webhook簽名和反重播是否包括在內？

4.是否實現了等效性、限制、outbox/inbox和DLQ?

5.是否設置了SLO/SLA dashboards、跟蹤、burn-rate變量?

6.Reconciliation和計算/歸因窗口是否正式化?

7.Geo-pinning/TTL/crypto-erasure和現場DSAR路由?

8.Semver, deprecation process和雙版本支持有記錄嗎?

9.事件花花公子被驗證（圖式漂移，SLO失敗，recon-diff）？

10.退出計劃： 斷開密鑰,導出數據,遷移到第二來源?

二.結論

合作夥伴集成是生產管道：標準→驗證→可觀察性→改進。當合作夥伴護照滿時，事件和合同被打字，認證和簽名是強制性的，SLO被測量，計算被核對，變化通過版本和門進行管理-生態系統快速安全地增長，每個新合作夥伴都增強了網絡的價值。