術語小辭典

你在 HSystem 建立的軟體單位。服務、用戶、金鑰、方案都掛在它底下，跨 App 的資料不會互通。

App 的公開識別碼。放前端沒問題，它不是密碼；用來告訴 API「這是哪一個 App」。

代表 App 本人的密鑰，只能放後端。外洩等於別人可以代你的 App 呼叫 API、讀寫你的用戶資料。

給自動化腳本與 AI 代理的開發者權杖，帶 scope（例如 pay:write）；可隨時撤銷，不必共用登入密碼。

一個 App 只能選一個平台方案；方案決定每個服務的免費額，超出才扣點。

平台計費用的點數。用量超過方案免費額時扣點，餘額不足會直接回 429，不會默默超收。

可上架的能力模組（auth、profile、pay、files…）。每個服務有自己的開關、設定與 OpenAPI 契約。

使用你的 App 的人。ID 建立後不更換，一個人在平台上只有一列。

依池分開存放的用戶資料。換池只切換正在讀寫的那一份，不另建用戶、不改寫 ID。

代表某個終端用戶的短期票，放在 Authorization: Bearer。只能碰自己的資料（除非用 App 金鑰）。

用來換新的 access_token。與 Auth 共用；撤銷後就換不到新票。

公開客戶端（瀏覽器、原生 App）換 token 的防護。code_challenge_method 只接受 S256。

每個個資欄位（email、顯示名稱、頭像…）的分享策略：允許、遮蔽或不提供。

使用者同意某個 App 使用哪些資料的紀錄。可撤銷；撤銷後相關請求回 403，而不是假裝成功。

免註冊的身份，每個 App 各自獨立。升級成正式帳號時同一個 user id 遷入正式池。

未取得授權的個資以遮蔽形式回傳（例如 a***@example.com）。這是正常結果，不是錯誤。

一家金流的帳號設定（綠界、Stripe…）。同一個 App 可以建多個帳號，並依地區排先後。

從商品與數量開始的一次收款。回傳的是付款表單欄位或導轉網址，不是「已付款」。

一次收款嘗試的狀態機：建立 → 需要動作 → 成功或失敗。退款與對帳都以它為單位。

交易結果。付款成功後才履約：虛擬商品直接完成，實體商品先待出貨、出貨後才算完成。

金流或平台主動打你的網址通知結果。一定要驗簽，並用事件 id 去重（同一則會重送）。

對已付款訂單退回金額，可部分退款。退款成功才會回補庫存與優惠券。

定期定額收款。支援換方案（立即生效或下期生效）與扣款失敗的催繳流程。

綠界 Einv B2C 的開立、查詢、作廢。金鑰與支付分開設定，支付停用不影響已開發票。

發票開立後的金額調整。退款時可以自動折讓，不必先作廢重開。

檔案在 App 內的位址（例如 avatars/me.png）。可用前綴管理，也能用路徑直接讀取。

只有帶對憑證才讀得到的檔案；公開檔案則任何人拿到網址就能讀。

公開 API 一律經過計量中介。用量報表與免費額判定都從這裡來，以 UTC 彙總。

同一把鑰匙重送只會產生一筆結果。重試付款、退款或開票時一定要帶。

回應固定是 { error, code }。請用 code 判斷（訊息文字會變），不要比對 error 的字串。