Plaid 金融科技

要解决什么问题

接入 Plaid 时，团队往往在 Link 会话、交易数据 freshness 和 Item 生命周期 上踩坑：linktoken 与 accesstoken 混用、用 /transactions/get 全量拉取、Item 失效后只打日志不引导用户重连。本技能把 Plaid 文档里分散的模式收成可执行的 checklist，方便在 Agent 对话里对齐实现细节。

技能覆盖的核心流程

• Link Token 创建与交换：为 Plaid Link 创建短期、一次性的 link_token；用户完成后将 public_token 交换为 不会过期 的 access_token（用户改密等场景下仍可能需要更新）。
• 交易同步：优先用 /transactions/sync 做增量更新，比 /transactions/get 更省调用；配合 webhook 做实时推送，避免固定间隔轮询。
• Item 错误与更新：遇到 ITEM_LOGIN_REQUIRED 时走 Link 更新模式 让用户重新授权；监听 PENDING_DISCONNECT webhook，在断开前主动提示用户。

反模式与边界

技能明确标注：不要 明文存 access token、不要 只靠轮询、不要 忽略 Item 级错误。表中若干 Issue 在原文仅指向官方文档，具体 remediation 需对照 Plaid 当前 API 与合规要求（加密存储、密钥轮换、环境 sandbox/production 隔离等），本技能不替代官方安全与合规指南。