如果你使用 vibe coding 或任何 AI 工具（Cursor、Claude Code、Windsurf）在開發自己的網站、產品或服務，想要讓用戶付費、收月費、賣單次商品，以前你可能要花好幾天研究如何完成交易。
這不只是處理金流、刷卡服務，還包含訂閱管理、發票開立、稅務申報。這些過去是 Portaly 系統的核心功能，現在有了 Portaly Payment Skill，你只需要幾個步驟，就能讓 AI agent 協助你將這套系統串接到你的 vibe coding 產品上！
這篇文章會帶你：
- 了解 Portaly Payment 能做什麼
- 安裝 Portaly Payment Skill，讓你的 AI 工具學會操作 Portaly
- 取得 API Key，讓 AI 開始串接
內容目錄
Portaly Payment 是什麼？
Portaly Payment 是 Portaly 提供的 Hosted Checkout（代管結帳）服務。
這套系統讓你不需要直接對接信用卡收款商、不需要自己建結帳頁面，也不需要分別處理 Email 驗證、發票開立、或訂閱週期管理… 這些都由 Portaly Payment 這套交易系統統一處理。
一筆完整的交易會包含這些環節
其中包含很多階段與步驟，但當使用 Portaly Payment ，你的系統只需要：
- 接收付款完成的通知，更新自己的資料庫
- 建立「結帳 Session」，取得 Portaly 給的結帳連結
- 把用戶導向 Portaly 的結帳頁
方案建立、驗證這些功能，AI 裝了 Portaly Payment Skill 之後會幫你搞定。
目前 Portaly Payment 支援以下兩種計費模式：
| 計費模式 | 說明 | 適合用途 |
| monthly | 每月自動續扣 | 訂閱制服務、會員制 |
| one-time | 單次付款，不自動續費 | 課程、電子書、數位商品 |
開始使用
Step 1：安裝 Portaly Payment Skill
Skill 是一包給 AI 用的說明書，告訴 AI 怎麼呼叫 Portaly API、怎麼幫你建立方案、怎麼產生串接程式碼。裝好之後，你只要用自然語言跟 AI 說你想做什麼，它就能協助你完成。
以下 AI coding 工具都支援 Skill 安裝：
- Cursor
- Claude Code
- Windsurf
- GitHub Copilot（agent）
- Codex
- 其他支援執行
npx skills指令的 AI 工具
安裝步驟
1. 複製 Skills 安裝指令
首先進到 Portaly Payment 後台（變現工具 > Payment），在「安装 Portaly 付款 Skill」區塊，點擊「複製 Prompt」。
也可以直接在此複製指令：
npx skills add portaly-ai/portaly-skills --skill portaly-payment2. 安裝 skills
複製完指令之後，可以選擇請 coding agent 協助安裝或是使用終端機（Terminal）安裝。
範例一：使用 Claude 安裝
- 選擇你的專案資料夾
- 貼上剛剛複製的安裝 Prompt
- Agent 會執行（第一次安裝的話可能會詢問是否同意執行安裝指令，點擊允許即可）
- 看到完成訊息，Skill 就裝好了！
範例二：終端機（Terminal）安裝
- 在你的專案根目錄打開終端機（Terminal），貼上並執行執行剛剛複製的指令。
- 指令跑起來後，會出現互動式選單，可選擇要安裝到哪些 AI 工具。如果你用的工具都在預設清單裡，直接按 Enter 就好。如果想新增或取消某個工具，可用上下鍵移動游標、空白鍵切換勾選，再按 Enter 確認。
- 接著會顯示安裝摘要和安全掃描結果，確認沒問題後選 Yes 繼續。
- 看到完成訊息，Skill 就裝好了！
3. 安裝完成
安裝完成後，你的專案裡會出現 .agents/skills/portaly-payment/ 資料夾。重新開啟你的 AI 工具（或重啟對話），它就能使用這個 Skill 了。
之後要更新 Skill 版本時，執行以下指令即可：
npx skills update portaly-paymentStep 2：申請 API Key
在 Portaly Payment 後台（變現工具 > Payment），在「建立 API Key 管理」區塊，點擊「建立新 API Key」建立一組 API Key。
建立時可以選擇不同模式的 API Key：
- Test 模式：測試用，不會真的扣款
- Live 模式：正式上線用，會觸發真實付款
建議先用 Test 模式開發，測試完成後再換 Live 模式。
PORTALY_API_KEY只在建立當下顯示一次，記得在瀏覽後記錄下來。
建立完成後會拿到兩個值：
PORTALY_API_KEY=pcs_test_xxxxxxxxxxxxxxxx
PORTALY_CALLBACK_SECRET=xxxxxxxxxxxxxxxx在專案目錄（通常在編輯器的左側）中可以找到 .env 檔，像是下張圖的專案架構中所示。把這兩個值直接貼到 .env 檔。如果使用 Git 管理程式碼的話，可一併確認 .gitignore 有包含到 .env，避免機密資料被推上 Git。
*特別留意：如果尚未通過「金流審核」，僅能使用「測試 API Key」。這時，確定串接測試成功，就趕快進行審核吧！
Step 3：讓 AI 幫你串接
Skill 裝好、API Key 存好之後，直接開口跟你的 AI agent 說你想做什麼就好。
以下是一些可以直接使用的提示語範例：
月費訂閱制
幫我用 Portaly Payment 建立一個月費 299 元的方案，然後在我的專案裡加上結帳流程，包含建立 checkout session 的 API 和處理付款完成 callback 的邏輯。
建立完成後，可以將自己專案中的商品透過 Portaly 頁面進行付款，例如以下付款畫面：
單次購買
我想賣一堂課程，定價 1980 元，一次付清。幫我用 Portaly Payment 串接，用戶按下購買後導到 Portaly 結帳，付完款後更新我資料庫的訂單狀態。
AI 裝了 Skill 之後，會知道怎麼呼叫 Portaly API 建立方案、在你的專案產生建立 checkout session 的程式碼、提醒你把 API Key 放進 .env 等。
月費訂閱管理
月費方案還支援取消、恢復訂閱，以及讓訂閱者自己管理的功能。這些都可以在已安裝 Portaly Payment Skills 的情況下，請 AI 幫你串接，例如：
幫我加一個「取消訂閱」的功能，用戶按下後停止下次自動扣款，但保留到當期結束。
AI 會幫你產生對應的程式碼，包含呼叫 Portaly API 和串接到你的網站流程。
折扣碼
想辦早鳥優惠或行銷活動？可以建立折扣碼，讓用戶結帳時輸入代碼享有優惠。例如：
幫我建立一個折扣碼「EARLYBIRD2026」，前 3 個月打五折，每個人只能用一次，截止日是今年底。
AI 會直接呼叫 Portaly API 建立折扣碼，也會幫你在結帳流程裡加上套用折扣的邏輯。
發票設定確認
Portaly Payment 會在每筆付款完成後自動處理發票，不需要你這邊另外串接電子發票系統。如果想確認設定是否正確，可以這樣請 AI 幫你：
幫我確認 Portaly Payment 的發票設定是否已啟用，確保用戶付款後能正確收到發票，不需要我們這邊另外處理。
串接流程總覽
AI 幫你串接完成後，整個交易流程如下：
你的系統只需要負責建立 Session、接收通知、更新自己的資料庫。其餘環節，包含從結帳介面到信用卡安全、從 Email 驗證到發票、從訂閱扣款到週期管理，都由 Portaly Payment 這套交易系統統一處理。
常見問題
Q：測試完成，要怎麼切換到正式收款？
回到 Portaly Payment 後台 建立一組 Live 模式的 API Key（會是 pcs_live_... 開頭），換掉 .env 裡的值就好，其他程式碼不需要改，方案也不需要重新建立。
Q：API Key 忘記存了，找不到原本的值怎麼辦？
回到 Portaly 後台重新建立一組新的 API Key 就好。不過要注意，建立每一組 API Key 時都會包含兩個搭配好的值：API Key（pcs_test_... 或 pcs_live_...）和 Callback Secret，這兩個是一對的，記得一起換掉 .env 裡的兩個值，不能只換其中一個。
總結
Portaly Payment 是一套代管的交易系統，把一筆交易所需的所有環節統一處理。透過 Portaly Payment Skill，AI 可以替你完成大部分的串接工作。
透過這篇教學，你可以：
- 用一行指令完成 Cursor、Claude Code、Windsurf 等工具的 Skill 安裝
- 用自然語言建立收款方案、處理 Webhook、設定測試環境
- 把訂閱管理、發票開立這些原本需要分別處理的環節，統一交給 Portaly Payment
- 專注在產品本身，不需要自己把交易系統的每個零件拼起來
立即開始：
- Portaly Payment 後台 → 建立 API Key
作者介紹
Portaly 台灣團隊開發的創作者商務平台，提供 Link-in-Bio 個人頁面、數位商品銷售與品牌合作媒合工具，幫助創作者將內容影響力轉化為收入。