Atoms
連接器

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 付款設定

  1. 連接 Supabase

    • 點擊 MGX 右上角的 Supabase 按鈕
    • 依照 Supabase 整合指南 選擇您的目標 Supabase 專案
    • 連接完成後,您即可透過 Supabase 設定付款相關設定
  2. 使用自然語言描述您的訂閱需求

    • 範例:建立一個付款系統,支援三種訂閱方案,價格分別為每週 $4.99、每月 $14.99,以及每年 $149.99。

    提交後,MGX 智能體 會產生設定按鈕。您至少需要填寫兩個欄位。

  3. 點擊 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" 按鈕來安全儲存。

  4. 點擊 Add Stripe Webhook Secret Key 按鈕

    • 輸入您的 Webhook Secret Key
  5. 如何找到 Webhook Secret Key:

    在 Stripe 中,點擊左下角的「Developers」,然後選擇 Webhooks 選項。

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

    選擇符合您專案需求的 webhook 事件:

    • checkout.session.async_payment_failed
    • checkout.session.async_payment_succeeded
    • checkout.session.completed
    • checkout.session.expired

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

    輸入來自 Supabase 的 endpoint URL。

  6. 如何找到您的 Supabase Endpoint URL:

    在 MGX 中點擊 View Edge Function

    • 點擊選取帶有對應 _webhook 後綴的 edge function。

    • 在對應 edge function 的 Details 面板中,複製 Endpoint URL,並將其貼到 Stripe Event Destination。

  7. 測試您的整合

    使用 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 頁面查看您的測試交易紀錄。

這個頁面有幫助嗎?

相關文章