使用者 profile

讀取 partner-specific 的使用者 key 與已授權的身份摘要。

GET /api/partner-auth/me

送出 Authorization: Bearer PARTNER_ACCESS_TOKEN。

回應一律包含 sub。其他物件只在 token 具有對應 scope 時才會出現:

  • profile.basic 對應 profile;
  • kyc.status 對應 kyc;
  • risk.summary 對應 risk。

KYC 與 risk 資料都以 Client 所屬 Merchant 的 context 評估。回應永遠不會揭露平台內部的 Identity Profile identifier;請以 partner-specific 的 sub 作為你穩定的外部 key。

授予 risk.summary 時,risk.eligibility 會包含此 Client 所屬 Merchant 最新的後端決策;尚無正式決策時為 null。結果為 eligible、limited、manual_review 或 blocked;client 應直接顯示結果與穩定的 reason code,不得在本地重新計算政策。

{
  "sub": "stable-partner-specific-sub",
  "profile": {
    "name": "Example User",
    "email": "[email protected]",
    "email_verified": true
  },
  "kyc": {
    "kyc_status": "approved",
    "identity_verified": true,
    "verified_at": "2026-07-13T08:00:00.000000Z"
  },
  "risk": {
    "risk_level": "normal",
    "risk_types": [],
    "eligibility": {
      "outcome": "limited",
      "reason_codes": ["device_trust_limited"],
      "policy_version": "early-access-core-v1",
      "decided_at": "2026-07-20T08:30:00.000000Z"
    }
  }
}