Webhooks in Bank Transfers

An overview of webhooks at Plaid is available in the API Reference. There you can find general information on Plaid webhooks, including IP addresses, webhook verification, and retry logic.

To enable Bank Transfers webhooks, add your endpoint on the account webhooks page of the dashboard. If you are not able to access the page, contact your Plaid Account Manager.

To confirm that your endpoint has been correctly configured, you can trigger a test webhook via /sandbox/bank_transfer/fire_webhook. You should receive the payload body specified below.

{
  "webhook_type": "BANK_TRANSFERS",
  "webhook_code": "BANK_TRANSFERS_EVENTS_UPDATE"
}

Upon receiving a BANK_TRANSFERS_EVENTS_UPDATE webhook, poll the events sync endpoint to process the available events. Note that there may only be one new event, or there may be many new events. Plaid will send a maximum of approximately 1 webhook per minute as new events continue to become available, unless you are using Bank Transfer webhooks for micro-deposit event notifications, in which case you will receive a separate webhook for each event.

// Webhook received
wait_for_and_ack_webhook();
// Fetch the maximum event ID from your systems
after_id = fetch_last_event_id();
var events = [];

// Poll event sync endpoint for all new events
do {
  // Fetch the next set of events and update after_id
  events = plaidClient.BankTransferEventSync(after_id);
  after_id += len(events);

  // Handle new events
  for (event of events) {
    yourEventHandler(event);
  }
} while (events.length > 0);