Stripe API 参考导航器

要解决的具体问题

在处理 Stripe 支付相关的开发时，工程师常面临 API 文档分散、场景化查询效率低的问题：Payment Intent 的生命周期流转、Webhook 事件的具体字段定义、Connect 平台的结算结构等知识点散落在不同页面，手动查阅不仅耗时，还容易因参数理解偏差引发线上问题。

核心能力与工作方式

1. 以 SDK 方法为锚点导航文档：依托 stripe-node SDK 的方法体系，将 API 文档与 SDK 调用逻辑关联，快速定位对应接口的参数、返回值及使用示例，减少跨页面跳转成本。
2. 场景化解析核心业务逻辑：针对 Payment Intent 生命周期（如 confirm、cancel 等状态流转）、Webhook 事件 schema（如 payment_intent.succeeded 的字段结构）、Connect 平台 payout 结构（如 balance 接口的资金分配规则）等核心场景，提供清晰的逻辑拆解。
3. 类型安全的参数校验支持：在解析接口参数时，结合类型定义规范参数格式，帮助开发者提前发现参数类型不匹配、必填项遗漏等问题，降低调试成本。

适用边界与注意点

• 需与 stripe-node SDK 版本保持一致，避免因 SDK 与文档版本差异导致查询结果与实际调用不匹配。
• 涉及敏感配置（如 Secret Key）的场景，需严格遵循安全规范操作，不可将密钥等敏感信息暴露在代码中。
• 对于 SDK 未覆盖的低阶 API 或边缘场景，可能需要结合官方文档手动补充确认。