Stripe 集成
MGX 现已支持通过 Supabase Edge Functions 快速配置 Stripe 支付。
要求
在集成 Stripe 之前,请确保您已具备:
- 一个可正常运行的 MGX 应用。
- MGX 项目已连接到一个 Supabase Project。(了解有关 Supabase 的更多信息。)
- 已在您的 Stripe dashboard 中创建产品及其对应价格。
注意: 预览模式无法用于测试支付功能。请部署您的 MGX 应用,并将 Stripe 切换到 Test Mode 以验证集成。
测试卡:
- 卡号:
4242 4242 4242 4242 - 到期日期:任意未来日期
- CVC:任意 3 位数字
Stripe 支付设置
连接 Supabase
- 点击 MGX 右上角的 Supabase 按钮
- 按照 Supabase 集成 Guides 选择您的目标 Supabase Project
- 连接完成后,您可以通过 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。您必须部署应用才能接收 Stripe 事件。
如何切换到 Production Mode?
您可以在 Stripe Dashboard 中禁用 Test Mode,并使用您的 live Secret Key 和 Webhook Secret。
如何验证测试支付是否成功?
完成测试支付后,前往 Stripe 中的 Payments 页面查看您的测试交易记录。