// plaid integration
Plaid webhook for linked-account events on localhost
Plaid posts webhooks when linked accounts produce events — new transactions, item update, error states. Sandbox flow against your laptop needs a public URL; lrok handles it.
1 · Set up the lrok tunnel
1. Reserve
$ lrok reserve plaid-dev2. Run handler
$ npm run dev3. Tunnel
$ lrok http 3000 --hint plaid-dev
2 · Configure Plaid
1. Plaid Dashboard → Team Settings → Webhooks
Webhook URL: https://plaid-dev.lrok.io/webhook. Different webhook URL per environment is allowed.
// plaid-specific gotcha
Plaid signs webhooks via JWT in the Plaid-Verification header. Verify with Plaid's webhookVerificationKey/get endpoint — the signing key rotates, so cache for ~24h. The body is the raw JSON Plaid sent.