必须通过dify自定义工具调用stripe api获取订阅与账单信息：先配置含read:subscriptions、read:invoices、read:customers权限的secret key为环境变量，再创建两个custom tool分别查询活跃订阅和最新发票，并在prompt中按序调用、解析并结构化输出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中实时获取用户在Stripe平台上的订阅状态（如是否活跃、到期时间）和最新账单信息（如金额、支付状态、发票PDF链接），必须通过Dify的自定义工具（Custom Tool）调用Stripe REST API，且需严格配置认证与权限范围。
准备Stripe Secret Key与API权限
登录Stripe Dashboard → 进入Developers → API keys → 复制Secret key（以sk_test_或sk_live_开头）。【该密钥拥有读写权限，切勿硬编码在前端或公开仓库中】
确认该密钥所属的API key pair已启用以下权限：read:subscriptions、read:invoices、read:customers。若使用Restricted keys，必须手动勾选这三项——缺少任一权限将导致对应接口返回403错误。
把Secret Key保存为Dify环境变量：在Dify项目设置 → Environment Variables中新增变量STRIPE_SECRET_KEY，值设为刚复制的密钥。
创建自定义工具：stripe_get_customer_subscription
进入Dify工作区 → Tools → Create Tool → 选择Custom Tool → 填写名称为stripe_get_customer_subscription。
在Schema字段粘贴以下JSON（注意替换${STRIPE_SECRET_KEY}为实际环境变量引用）：
{ "parameters": { "type": "object", "properties": { "customer_id": { "type": "string", "description": "Stripe Customer ID，格式如cus_123456789" } }, "required": ["customer_id"] }, "responses": { "200": { "description": "Success", "schema": { "type": "object", "properties": { "status": { "type": "string" }, "current_period_end": { "type": "integer" }, "cancel_at_period_end": { "type": "boolean" } } } } } }
在HTTP Request配置中：Method选GET，URL填https://api.stripe.com/v1/customers/${customer_id}/subscriptions，Headers加Authorization: Bearer ${STRIPE_SECRET_KEY}，Query Parameters添加status=active（确保只查有效订阅）。
创建自定义工具：stripe_get_latest_invoice
新建第二个Custom Tool，命名为stripe_get_latest_invoice。
Schema中parameters仅保留customer_id字段，responses定义invoice_number、amount_due、status、hosted_invoice_url四个关键字段。
HTTP Request：Method选GET，URL设为https://api.stripe.com/v1/invoices，Headers同上，Query Parameters添加customer=${customer_id}&limit=1&status=invoiced，确保只取最近一张已开票且未作废的账单。
这一步不能省略limit=1参数，否则API默认返回10条，工具解析会失败。
在Prompt中调用两个工具并结构化输出
编辑应用的Prompt，在需要展示用户付费状态的位置插入如下调用指令：
第一步：调用stripe_get_customer_subscription，传入用户档案中存储的Stripe customer_id；
第二步：若上一步返回status为active，则立即调用stripe_get_latest_invoice，复用同一customer_id；
第三步：将两工具返回的current_period_end（转为YYYY-MM-DD格式）、cancel_at_period_end、amount_due（除以100转为元）、hosted_invoice_url拼合成自然语言句子，例如：“您的订阅有效期至2025-06-15，下期账单金额为¥299.00，查看发票。”
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
