如何在Plaid中为同一用户配置多个user token？

你对Plaid的user token设计逻辑理解有偏差，才会遇到这个报错：

1. client_user_id是你为自己平台用户分配的唯一标识，同一个平台用户全局只能对应一个client_user_id，也只能对应一个有效的user token，重复调用创建接口必然报错，这是Plaid做用户维度数据归集的固有设计，不是接口bug。
2. user token本身不绑定单次Plaid Link录入的支付方式数据，它只是用户维度的权限凭证，用来授权你访问该用户下所有关联Item（每完成一次Plaid Link流程就会生成一个独立access_token，对应一个Item，也就是一个支付方式）的授权数据，包括Income模块的数据。
   你遇到的「user token仅对应用户最近一次录入数据」问题，本质是后续初始化Plaid Link时传参错误——没有把用户已有的user token传入配置，Plaid会判定这是新用户的绑卡请求，自然无法归集之前的绑定数据。

• 首次绑卡流程：用户第一次在你的平台触发支付方式绑定的时候，再调用/user/create接口，用你平台自身的用户唯一ID作为client_user_id生成user token，把这个token持久化存储到你的用户表中，和平台用户ID做一一绑定。后续这个用户的所有绑卡相关操作，都复用这一个token，永远不要再为该用户调用/user/create接口。
• 新增支付方式流程：用户后续触发新增绑卡操作、初始化Plaid Link时，必须在Link配置参数中传入该用户已经绑定的存量user token，不要留空也不要尝试传新生成的token。用户走完Link流程后，新生成的access_token会自动归集到该user token对应的用户实体下，不会覆盖之前已经绑定的任何支付方式。
• 数据拉取逻辑：如果要拉取用户全量的Income等聚合数据，直接用绑定的user token调用对应接口即可，接口会自动返回该用户下所有已绑定支付方式的合并数据；如果需要拉取单个支付方式的独立数据，用对应Item的access_token调用单资源接口就行。
• 冗余数据清理：如果之前测试阶段已经给同一个用户重复生成了多个user token，先调用/item/remove清理掉冗余的测试Item，再调用/user/remove删掉多余的user token，只保留一个和用户绑定的有效token即可，避免后续数据串扰。

别尝试给同一个平台用户构造不同的client_user_id绕开重复校验，这种操作会把同一个用户在Plaid侧拆成多个独立实体，后续做数据合并、合规校验的时候会出严重问题，完全不符合Plaid的接口设计规范。

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