---
{
  "id": "platform.space.runtime-commerce",
  "topic": "space",
  "title": "受管 Space 執行階段橋接與商務",
  "locale": "zh-TW",
  "version": "2026-08-12",
  "summary": "Protocol v1 以每個 iframe 專屬 token 綁定 opaque Space，提供經同意的 OAuth scopes，並把購買確認與可信庫存交由平台 Host 處理。",
  "content": "`arinova:ready` 由伺服器注入，Space 作者程式不可自行傳送。Parent 會核對確切 iframe window、fragment 綁定的 `bridgeToken` 與 `protocolVersion: 1`，再以 `arinova:auth` 傳送使用者 profile、scopes、短效 OAuth access token、選用 agents 與到期時間。Token 只能留在記憶體。Space 可針對已宣告的 `agents` 或 `economy` 傳送 `arinova:request-scope`；同意後會收到更新的 auth，拒絕則收到 `arinova:scope-denied`，這是正常且不應讓 App 崩潰的結果。\n\nApp 內扣點要用 `arinova:purchase-request`，不可直接呼叫 debit。Host 會讀取可信商品目錄、顯示原生確認、以目前價格與 idempotency key 執行 session-authenticated purchase，再回 `arinova:purchase-result`。結果為 `purchased`、`cancelled` 或 `error`。Runtime OAuth endpoints 可列出商品與庫存並原子扣除數量；永久商品擁有權與訂閱狀態都保留在伺服器。\n\n停用訂閱商品只停止新購買，不會停止既有續訂。獨立的 wind-down 會停止銷售、把有效訂閱設為週期結束時取消，並通知訂閱者。既有訂閱價格是快照；編輯目錄價格只影響新訂閱者。Paid-funded 商務會把 70% 計入創作者收益，bonus-funded 點數不產生收益；管理員退款與訂閱 clawback 會沖回可歸屬收益。\n",
  "aliases": [
    "Space bridge",
    "arinova auth 訊息",
    "要求 Space scope",
    "Space App 內購買",
    "Space 庫存",
    "Space 商品訂閱",
    "Space 創作者收益"
  ],
  "tags": [
    "space",
    "bridge",
    "commerce",
    "subscription",
    "consent"
  ],
  "relatedActions": [
    "arinova.web.search"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/space/runtime-commerce/"
}
---

`arinova:ready` 由伺服器注入，Space 作者程式不可自行傳送。Parent 會核對確切 iframe window、fragment 綁定的 `bridgeToken` 與 `protocolVersion: 1`，再以 `arinova:auth` 傳送使用者 profile、scopes、短效 OAuth access token、選用 agents 與到期時間。Token 只能留在記憶體。Space 可針對已宣告的 `agents` 或 `economy` 傳送 `arinova:request-scope`；同意後會收到更新的 auth，拒絕則收到 `arinova:scope-denied`，這是正常且不應讓 App 崩潰的結果。

App 內扣點要用 `arinova:purchase-request`，不可直接呼叫 debit。Host 會讀取可信商品目錄、顯示原生確認、以目前價格與 idempotency key 執行 session-authenticated purchase，再回 `arinova:purchase-result`。結果為 `purchased`、`cancelled` 或 `error`。Runtime OAuth endpoints 可列出商品與庫存並原子扣除數量；永久商品擁有權與訂閱狀態都保留在伺服器。

停用訂閱商品只停止新購買，不會停止既有續訂。獨立的 wind-down 會停止銷售、把有效訂閱設為週期結束時取消，並通知訂閱者。既有訂閱價格是快照；編輯目錄價格只影響新訂閱者。Paid-funded 商務會把 70% 計入創作者收益，bonus-funded 點數不產生收益；管理員退款與訂閱 clawback 會沖回可歸屬收益。