Plaid银行收入验证未触发Webhook问题咨询

1. 该行为是否正常？ #

银行收入报告流程的Webhook触发逻辑和薪资收入报告不完全一致，你遇到的收不到Webhook的情况是可能存在的，并非绝对异常。核心差异在于：

• 薪资收入报告（尤其是雇主验证流程）会在处理完成后稳定触发INCOME_VERIFICATION Webhook；
• 银行收入报告依赖交易数据分析，若Sandbox测试数据的交易模式不符合收入识别规则，或流程未满足Webhook触发阈值，就可能不会发送通知。

2. 如何判断银行收入报告已就绪可调用？ #

如果收不到Webhook，可通过以下两种方式主动校验：

方式一：调用API主动查询报告状态 #

使用income_verification/get或income_verification_preview/get接口查询，Node.js示例代码如下：

const plaid = require('plaid');

const client = new plaid.Client({
  clientID: 'YOUR_CLIENT_ID',
  secret: 'YOUR_SECRET',
  env: plaid.environments.sandbox,
});

client.incomeVerificationGet({
  income_verification_id: 'YOUR_INCOME_VERIFICATION_ID',
})
.then(response => {
  const { verification_status } = response.data;
  if (verification_status === 'VERIFICATION_STATUS_PROCESSING_COMPLETE') {
    // 报告已就绪，可提取完整数据
    console.log('收入报告生成完成:', response.data);
  } else {
    // 报告仍在处理，建议稍后重试
    console.log('报告处理中，当前状态:', verification_status);
  }
})
.catch(err => {
  console.error('查询报告状态失败:', err);
});

重点关注返回结果中的verification_status字段，当值为VERIFICATION_STATUS_PROCESSING_COMPLETE时，说明报告已就绪。

方式二：检查Sandbox测试数据配置 #

在Sandbox环境中，确保连接的测试银行账户包含符合Plaid收入识别规则的交易（比如定期固定金额的入账）。若测试数据不符合要求，Plaid无法生成有效报告，自然不会触发Webhook。可在Plaid Dashboard的Sandbox模块重置或修改测试账户的交易数据后重新测试。

额外注意事项 #

• 确认Plaid Dashboard中Webhook配置正确，且你的服务器能正常接收POST请求（可通过本地调试工具验证端点可达性）；
• Sandbox环境下银行收入报告处理通常即时完成，生产环境可能需要几分钟到数小时，需根据场景调整查询间隔。

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