stripe-sync-engine
将Stripe支付数据实时同步到PostgreSQL数据库的TypeScript库。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：stripe-sync-engine。 它的用途是：将Stripe支付数据实时同步到PostgreSQL数据库的TypeScript库。 完整的 Skill 内容见：https://321skill.com/skills/stripe-sync-engine/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我的Node.js服务需要把Stripe的客户和订阅数据存到自己的PostgreSQL里，用于生成内部报表。”，它会建议你使用stripe-sync-engine库，并展示如何初始化配置、处理Webhook以及进行初始数据回填，帮你快速建立可靠的数据同步通道。
介绍
Stripe Sync Engine 是一个专为Node.js后端和Serverless环境设计的TypeScript库，它解决了开发者需要将Stripe平台上的业务数据（如客户、发票、产品等）可靠地同步到自有PostgreSQL数据库中的痛点。通过该库，您可以轻松建立数据同步管道，避免直接依赖Stripe API进行复杂查询，从而提升数据访问速度和自主性。
使用方式非常直接，通过npm等包管理器安装后，在代码中引入并配置数据库连接和Stripe密钥即可。核心功能包括处理Stripe Webhook以实现实时数据更新，以及支持历史数据回填和实体重新验证，确保数据库与Stripe源数据的一致性。
这个Skill非常适合需要深度分析支付数据、构建内部管理后台或实现复杂业务逻辑的团队。后端开发、全栈开发和运维工程师是其主要使用者，他们通常负责构建和维护与支付相关的业务系统。
在使用时，建议仔细配置数据库连接池参数以适应您的并发需求，并确保妥善保管Stripe的Webhook签名密钥以验证请求来源。对于数据量较大的场景，可以考虑分批次进行初始数据回填。
核心特点
与手动调用Stripe API并写入数据库的方案相比，它封装了完整的同步逻辑和Webhook处理，提供了开箱即用的数据表结构和实时更新机制；相较于其他同步工具，它专为PostgreSQL设计，深度集成Stripe事件流，确保了数据的一致性和可靠性。
注意事项
目前仅支持PostgreSQL数据库，且主要面向Node.js技术栈，不适合需要同步到其他类型数据库或使用其他后端语言的项目。
常见问题
这个库支持同步哪些Stripe对象？
支持同步客户、发票、产品、价格、订阅、付款意向等核心Stripe业务对象。
如何在Serverless函数中使用？
可以像在普通Node.js环境中一样导入使用，但需注意配置数据库连接池以适应无状态环境，并处理好Webhook的快速响应。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/stripe-sync-engine/raw/index.md 读取 stripe-sync-engine 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/stripe-sync-engine/raw/index.md（查看排版版本）