name: plaid-fintech description: “专家模式,用于Plaid API集成,包括链接令牌流程、交易同步、身份验证、ACH授权、余额检查、webhook处理和金融科技合规最佳实践。使用场景:plaid,银行账户链接,银行连接,ACH,账户聚合。” source: vibeship-spawner-skills (Apache 2.0)
Plaid金融科技
模式
链接令牌创建与交换
为Plaid Link创建链接令牌,用公共令牌交换访问令牌。链接令牌是短寿命、一次性的。访问令牌不会过期,但用户更改密码时可能需要更新。
交易同步
使用/transactions/sync进行增量交易更新。比/transactions/get更高效。处理webhook以获取实时更新,而不是轮询。
项目错误处理与更新模式
通过让用户进入Link更新模式来处理ITEM_LOGIN_REQUIRED错误。监听PENDING_DISCONNECT webhook以主动提示用户。
反模式
❌ 明文存储访问令牌
❌ 使用轮询而非Webhooks
❌ 忽略项目错误
⚠️ 尖锐问题
| 问题 | 严重性 | 解决方案 |
|---|---|---|
| Issue | critical | 查看文档 |
| Issue | high | 查看文档 |
| Issue | high | 查看文档 |
| Issue | high | 查看文档 |
| Issue | medium | 查看文档 |
| Issue | medium | 查看文档 |
| Issue | medium | 查看文档 |
| Issue | medium | 查看文档 |