关于 plaid-fintech
面向 Plaid 集成开发的技能,提供 Link 令牌交换、交易同步及 Item 错误处理的实践指导,并说明常见安全与轮询误区。
主要功能
- 01创建和交换 Link 令牌
- 02增量同步交易
- 03处理 Item 登录错误
- 04使用 Webhook 接收更新
适用场景
- 01实现 Plaid Link 身份验证
- 02同步账户交易变更
- 03处理用户重新登录
- 04设计交易更新通知
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ davila7/ claude-code-templates --skill plaid-fintech安装后在 Claude Code 中输入/plaid-fintech确认已加载。
详细介绍
Plaid 金融科技
模式
创建和交换 Link Token
为 Plaid Link 创建 link_token,将 public_token 交换为 access_token。 Link Token 有效期很短,且只能使用一次。Access Token 不会过期,但 用户更改密码后可能需要更新。
交易同步
使用 /transactions/sync 获取增量交易更新。相比 /transactions/get, 这种方式效率更高。请处理 Webhook,以实时获取更新,而不是轮询。
Item 错误处理和更新模式
遇到 ITEM_LOGIN_REQUIRED 错误时,引导用户进入 Link 更新模式。 监听 PENDING_DISCONNECT Webhook,主动提示用户。
反模式
❌ 以纯文本形式存储 Access Token
❌ 使用轮询而非 Webhook
❌ 忽略 Item 错误
⚠️ 易踩坑
| 问题 | 严重性 | 解决方案 |
|---|---|---|
| 问题 | 严重 | 参阅文档 |
| 问题 | 高 | 参阅文档 |
| 问题 | 高 | 参阅文档 |
| 问题 | 高 | 参阅文档 |
| 问题 | 中 | 参阅文档 |
| 问题 | 中 | 参阅文档 |
| 问题 | 中 | 参阅文档 |
| 问题 | 中 | 参阅文档 |
评论
支持 Markdown