Plaid返回item_id的含义、变动原因及与InstitutionID区别咨询

Plaid Public Exchange Token 标准返回示例 #

{
  "access_token": "access-sandbox-de3ce8ef-33f8-452c-a685-8671031fc0f6",
  "item_id": "M5eVJqLnv3tbzdngLDp9FL5OlDNxlNhlE55op",
  "request_id": "Aim3b"
}

问题1：item_id含义及变动原因 #

• item_id是Plaid为单用户单金融机构的授权连接分配的唯一标识符，和同一次请求返回的access_token是一一绑定的关系，每一个item_id对应一条独立的授权会话记录。
• 多次请求时item_id变动属于正常设计：你每发起一次新的Plaid Link授权流程、兑换一次新的Public Token，本质上都是创建了一条全新的授权连接，即使用户选择的是同一家机构、同一个金融账号，Plaid也会生成新的item_id和对应的access_token，不存在复用逻辑。

问题2：item_id与institution_id的区别及开发使用规范 #

• 二者完全不同：institution_id是Plaid给每个合作金融机构分配的全局固定ID，所有用户授权同一家金融机构的连接都会共享同一个institution_id；而item_id是单条授权连接的专属ID，不存在复用性，即便是同一用户同一机构的两次授权，生成的item_id也完全不同。
• 开发中正确使用方式：
  • 服务端需要将item_id和你自有系统的用户账号做持久化绑定，后续调用Plaid的产品接口（交易、余额、身份验证等）时，部分接口需要传入item_id作为授权校验参数
  • 排查授权连接异常时，可通过item_id快速定位对应会话，做刷新权限、删除无效连接等操作
  • 不要用item_id做机构维度的统计、筛选，这类需求统一使用institution_id实现

内容的提问来源于stack exchange，提问作者Undevtaker