Stripe 整合
MGX 現在支援透過 Supabase Edge Functions 快速設定 Stripe 付款。
需求
在整合 Stripe 之前,請確認您已具備:
- 一個可正常運作的 MGX 應用程式。
- MGX 專案已連接到一個 Supabase 專案。(進一步了解 Supabase。)
- 已在您的 Stripe dashboard 中建立產品及其對應價格。
注意: 無法使用預覽模式測試付款功能。請部署您的 MGX app,並將 Stripe 切換到 Test Mode 以驗證整合。
測試卡:
- 卡號:
4242 4242 4242 4242 - 到期日:任何未來日期
- CVC:任何 3 位數字
Stripe 付款設定
連接 Supabase
- 點擊 MGX 右上角的 Supabase 按鈕
- 依照 Supabase 整合指南 選擇您的目標 Supabase 專案
- 連接完成後,您即可透過 Supabase 設定付款相關設定
使用自然語言描述您的訂閱需求
- 範例:建立一個付款系統,支援三種訂閱方案,價格分別為每週 $4.99、每月 $14.99,以及每年 $149.99。
提交後,MGX 智能體 會產生設定按鈕。您至少需要填寫兩個欄位。
點擊
Add Stripe Secret Key按鈕
- 在 STRIPE_SECRET_KEY 欄位中輸入您的 Stripe secret key。
- 針對每個方案,在以 PRICE_ID 結尾的欄位中輸入其對應的 Stripe Price ID。

您可以在這裡取得您的 Stripe secret key:https://dashboard.stripe.com/test/apikeys
前往 Product Catalog > Products,使用以下任一方法取得 price ID:
- 在「Pricing」清單中,點擊對應價格右側的「More」按鈕,然後點擊「Copy Price ID」。

您也可以直接點擊價格名稱開啟詳細頁面,然後複製右上角顯示的 price ID。

最後,請將每個 price ID 準確貼到對應的輸入欄位中。

注意: 為了隱私與安全,請勿直接將您的 secret key 貼到 MGX 聊天中。若外洩,可能會讓未經授權的人存取您的 Stripe 帳戶。請改用 MGX 的 "Add API Key" 按鈕來安全儲存。
點擊
Add Stripe Webhook Secret Key按鈕
- 輸入您的 Webhook Secret Key
如何找到 Webhook Secret Key:
在 Stripe 中,點擊左下角的「Developers」,然後選擇 Webhooks 選項。

在 Webhooks 頁面上,點擊 "Add destination" 按鈕。

選擇符合您專案需求的 webhook 事件:
checkout.session.async_payment_failedcheckout.session.async_payment_succeededcheckout.session.completedcheckout.session.expired

點擊 "Continue" 後,選擇 "Webhook endpoint."。

輸入來自 Supabase 的 endpoint URL。

如何找到您的 Supabase Endpoint URL:
在 MGX 中點擊
View Edge Function。
點擊選取帶有對應
_webhook後綴的 edge function。
在對應 edge function 的 Details 面板中,複製 Endpoint URL,並將其貼到 Stripe Event Destination。

測試您的整合
使用 Stripe 的 Test Mode 測試付款。
測試卡資訊:
- 卡號:4242 4242 4242 4242
- 任何未來的到期日
- 任何 3 位數 CVC
常見問題
為什麼我無法在預覽模式中測試付款?
預覽模式在本機環境中執行,無法提供可公開存取的 Webhook URL。您必須先部署 app,才能接收 Stripe 事件。
我要如何切換到 Production Mode?
您可以在 Stripe Dashboard 中停用 Test Mode,並使用您的正式 Secret Key 與 Webhook Secret。
我要如何確認測試付款是否成功?
完成一次測試付款後,前往 Stripe 的 Payments 頁面查看您的測試交易紀錄。