Link Token请求中Products枚举的正确使用方法咨询

常见400错误的原因 #

• 产品组合不兼容：Plaid不允许任意产品组合，部分产品存在依赖关系或互斥性。比如investments类产品仅适用于投资机构，无法与普通银行的auth/transactions组合使用；部分高级产品（如liabilities）需要搭配基础产品（如auth）才能生效。
• 账号权限不足：部分产品（如investments、liabilities、payment_initiation）需要向Plaid申请开通权限，未开通时传入会直接返回400。
• 机构不支持：某些机构仅支持特定产品，强行传入不支持的产品会触发错误。

正确用法与最佳实践 #

1. 优先使用枚举常量而非硬编码字符串 #

避免使用Products.fromValue("auth")这种易出错的硬编码方式，直接调用枚举常量：

LinkTokenCreateRequest request = new LinkTokenCreateRequest()
        .user(user)
        .clientName("Plaid Test App")
        .products(Arrays.asList(Products.AUTH, Products.TRANSACTIONS, Products.IDENTITY));

2. 选择通用型产品组合（覆盖绝大多数机构） #

如果目标是让用户连接尽可能多的银行/机构，推荐使用以下通用组合，这是绝大多数金融机构都支持的基础产品：

• AUTH：验证账户所有权与路由信息
• TRANSACTIONS：获取交易明细
• IDENTITY：获取账户持有人身份信息

3. 按需添加特定产品（需提前确认权限与兼容性） #

如果需要高级功能，比如投资账户、负债信息，需满足两个条件：

1. 你的Plaid账号已开通对应产品权限；
2. 仅针对支持该产品的机构使用，避免与不兼容产品混用。例如：

// 仅针对投资类机构使用的组合
Arrays.asList(Products.INVESTMENTS, Products.INVESTMENTS_TRANSACTIONS);

4. 利用Plaid的动态适配能力 #

不需要手动指定所有产品来覆盖所有场景。创建Link Token时传入通用产品组合后，Plaid Link会自动检测目标机构支持的所有产品，并在流程中展示该机构可用的功能，无需你手动枚举所有产品。

排查400错误的关键步骤 #

返回400时，务必查看响应中的error_details字段，Plaid会明确说明错误原因：

• 若提示"invalid product combination"，需调整产品组合；
• 若提示"product not enabled for account"，需向Plaid申请开通对应产品权限；
• 若提示"institution does not support product"，需移除该机构不支持的产品。

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