免費體驗版
免費體驗版
NT$0，先看一次成果，再決定要不要升級。
https://unclehouse.net/api/webhooks/portaly?productKey=preview
房叔自媒體學院｜房叔 AI Director OS房叔 AI Director OS
把四個商品直接接到同一套授權流程
這一頁是給操作與設定用的，照著填就能把 Portaly 商品接到房叔 AI Director OS 的 webhook、claim、unlock 與 V3 門禁流程。
四個商品對應
第一支成交版
第一支成交版
分成自己生成 NT$199 與系統生成 NT$599。
https://unclehouse.net/api/webhooks/portaly?productKey=pro
每月更新版
每月更新版
NT$990 / 月，每月固定更新內容與授權。
https://unclehouse.net/api/webhooks/portaly?productKey=monthly
專屬建制版
專屬建制版
NT$9,990 / 一次性，人工確認、客製建置、長期導入。
https://unclehouse.net/api/webhooks/portaly?productKey=custom
Portaly 後台欄位對照表
如果你要在 Portaly 後台逐一建立商品，就直接照下面這張表填。
免費體驗版
商品名稱：免費體驗版
productKey：preview
planType：grant
Webhook URL：https://unclehouse.net/api/webhooks/portaly?productKey=preview
說明：NT$0，先看一次成果，再決定要不要升級。
第一支成交版
商品名稱：第一支成交版
productKey：pro
planType：grant
Webhook URL：https://unclehouse.net/api/webhooks/portaly?productKey=pro
說明：分成自己生成 NT$199 與系統生成 NT$599。
每月更新版
商品名稱：每月更新版
productKey：monthly
planType：subscription
Webhook URL：https://unclehouse.net/api/webhooks/portaly?productKey=monthly
說明：NT$990 / 月，每月固定更新內容與授權。
專屬建制版
商品名稱：專屬建制版
productKey：custom
planType：lifetime
Webhook URL：https://unclehouse.net/api/webhooks/portaly?productKey=custom
說明：NT$9,990 / 一次性，人工確認、客製建置、長期導入。
Portaly 最終版商品文案
這段可以直接複製去商品說明或備註。
1. 免費體驗版 = NT$0
先看一次預覽結果，免費版只看一次。
2. 第一支成交版
(1) 自己生成 = NT$199
自備 API Key 輸入，只跑一次。
(2) 系統生成 = NT$599
系統直接生成完整 1280 內容包。
3. 每月更新版 = NT$990 / 月
商品內容不變，每月固定更新。
4. 專屬建制版 = NT$9,990 / 一次性
一次性建制，適合團隊或高意願客戶。
Portaly 純文字版
這段最短，可以直接貼到商品名稱、描述、按鈕文字欄位。
商品名稱：免費體驗版
商品描述：NT$0，先看一次成果，再決定要不要升級。
按鈕文字：開始免費預覽
商品名稱：第一支成交版
商品描述：分成自己生成 NT$199 與系統生成 NT$599。先看完預覽，再選你要的升級方式。
按鈕文字：查看升級選項
商品名稱：每月更新版
商品描述：NT$990 / 月，每月固定更新內容與授權。
按鈕文字：訂閱每月更新版
商品名稱：專屬建制版
商品描述：NT$9,990 / 一次性，適合團隊或高意願客戶。
按鈕文字：申請專屬建制版
設定步驟
- 在 Portaly 每個商品後台填上對應的 webhook URL。
- 免費體驗版、第一支成交版、每月更新版、專屬建制版都指向同一個 webhook endpoint。
- 如果 Portaly 能帶 query string，就加上 `productKey`。
- 付款成功後，webhook 會回傳 claimUrl 與 unlockUrl。
- 使用者打開 unlock 連結後，就會自動開通並進入 V3。
測試 payload
這是你在 Portaly webhook 測試時可以直接拿來驗證的範例 JSON。
{
"email": "buyer@example.com",
"orderId": "order_123456",
"productName": "免費體驗版",
"productSlug": "preview",
"eventType": "purchase",
"planType": "grant",
"entitlementKey": "v3"
}
後端規則
- URL 不是權限，權限會寫進 cookie 與 token。
- 前端與 API 都會再驗證一次。
- 未授權會導回 `/unlock`。
- 這套規則未來也會沿用到 V4。
退款撤權狀態服務
如果你還沒有 n8n / Sheets / DB，可以先用站內範例做測試。
狀態服務 URL：https://unclehouse.net/api/access/status
預設回傳：checked=true / revoked=false / source=example-access-status
可選環境變數：AID_OS_REVOKED_EMAILS / AID_OS_REVOKED_ORDER_IDS / AID_OS_REVOKED_PRODUCT_KEYS
升級路徑
免費體驗版 → 第一支成交版 → 每月更新版 → 專屬建制版。
測試結果
按下上面的「送出測試」後，這裡會顯示 webhook 回傳內容。
等你送出第一筆測試 webhook