授權
在使用者登入並同意後，建立短效 authorization code。
POST /api/partner-auth/authorize
此 endpoint 需要已完成 Email 驗證的 Sanctum 登入使用者。eKYC App 會在顯示 Partner Client 與所請求的 scopes 之後呼叫它。
JSON body
| 欄位 | 必填 | 說明 |
|---|---|---|
client_id | 是 | 已註冊且 active 的 Partner Client，其 Organization 與 Merchant 也必須為 active。 |
redirect_uri | 是 | 與 allowlist 完全相符的 callback URI。 |
scope | 是 | 以空白分隔、非空的 scope 清單。 |
state | 否 | 不透明的 state，會原封不動回傳。Application 應一律提供。 |
201 回應
{
"redirect_uri": "sample-app://auth/ekyc/callback",
"code": "SHORT_LIVED_CODE",
"state": "RANDOM_STATE",
"scope": "profile.basic kyc.status",
"expires_at": "2026-07-13T10:05:00.000000Z"
}
回應不包含 OCR 欄位、證件路徑、media URL 或 access token。
code_challenge 為選用的 S256 PKCE challenge（43–128 字元，base64url）。一旦送出，POST /api/partner-auth/token 就必須帶能驗證通過的 code_verifier，否則回 401。code_challenge_method 只接受 S256。