Native Stripe

💳 官方 API 直连,支付数据一手掌控

直连 Stripe 官方 API 管理支付数据,支持查询交易、客户、订阅、退款等操作,无需第三方代理。

收藏
3k
安装
1.3k
版本
1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

Stripe 支付数据管理 Skill 评估

核心用法

本 Skill 提供通过官方 Stripe API(api.stripe.com)直接查询和管理支付数据的能力。主要功能涵盖:

  • 数据查询:列出交易记录(charges)、客户信息、订阅状态、发票、付款意图、产品定价、退款记录等
  • 精准检索:支持按邮箱搜索客户、按状态筛选订阅(如 active)、获取特定对象详情
  • 操作功能:创建退款(支持部分退款)、更新客户信息(邮箱、姓名等)
  • 输出格式:列表数据以格式化表格呈现,单对象返回 JSON,支持 --json 标志获取原始数据
  • 分页与过滤:内置分页机制,可自定义返回数量限制

显著优点

1. 官方直连:直接调用 api.stripe.com,无第三方代理,降低中间人攻击风险
2. 功能完备:覆盖 Stripe 核心资源类型(charges、customers、subscriptions、invoices、payment_intents、refunds、products、prices、balance_transactions)

3. 操作灵活性:不仅限于查询,还支持退款创建和客户信息更新

4. 测试/生产双模式:支持 sk_test_* 测试密钥与 sk_live_* 生产密钥

5. 输出友好:表格化展示便于快速阅读,JSON 模式便于程序化处理

潜在缺点与局限性

1. 只读为主:创建/更新功能仅限于 refunds 和 customers,不支持创建 charges、products、subscriptions 等核心交易
2. 无 Webhook 支持:无法实时接收 Stripe 事件推送,仅能主动轮询查询

3. 密钥管理风险:依赖 STRIPE_SECRET_KEY 环境变量,密钥泄露可导致账户资金风险

4. 无内置加密:密钥以明文形式存储于环境变量,需依赖系统级安全防护

5. Python 依赖:需预装 python3 运行环境

适合人群

  • 财务/运营人员:需要快速查询交易状态、客户订阅情况
  • 开发者:调试支付流程、验证数据一致性
  • 客服团队:处理退款请求、更新客户联系信息
  • 中小型企业主:自助管理 Stripe 账户,无需开发完整后台

常规风险

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | Secret key 具备全账户权限,泄露可导致资金损失 | 使用最小权限密钥、定期轮换、避免硬编码 |
| 误操作退款 | 命令行操作缺乏二次确认,可能误触退款 | 生产环境使用只读密钥,退款操作需审批流程 |
| 数据暴露 | 查询结果包含敏感客户信息(邮箱、交易金额) | 确保执行环境安全,避免日志泄露 |
| 权限边界 | 更新操作可能影响生产数据 | 优先使用测试环境验证命令 |

总体评估

作为 Stripe 官方 API 的命令行封装工具,本 Skill 在查询场景下表现优秀,操作类功能则适合低风险、高频次的简单更新。建议配合严格的密钥管理制度使用,避免在生产环境直接执行资金敏感操作。

Native Stripe 内容

scripts文件夹
手动下载zip · 5.7 kB
stripe_query.pytext/plain
请选择文件