将合作伙伴整合到生态系统中

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被测量，计算被核对，变化通过版本和门进行管理-生态系统快速安全地增长，每个新合作伙伴都增强了网络的价值。