Skip to main content

Account Lifecycle and Status

Accounts move through a defined set of statuses that reflect their current state:
Common causes of Disabled status: the Entity’s consent was withdrawn, the Entity’s verification expired or was revoked, the account was flagged by Method’s risk monitoring, or your team explicitly disabled it via the API. Check the account’s error field for the specific reason.

State Transitions

  • Processing → Active: Account setup or verification completes successfully
  • Active → Disabled: Account is flagged for an issue or explicitly disabled. May be reversible — listen for account.active webhooks
  • Active → Closed: Method detects the account is closed at the financial institution (debt paid off, card canceled, loan settled)
  • Disabled → Active: The issue is resolved and the account is re-enabled
  • Closed is terminal — closed accounts do not reopen
Webhook tip: Subscribe to account.active, account.disabled, and account.closed webhook events to handle transitions in real time rather than polling.

Key Webhooks

  • account.active: Account transitioned to Active
  • account.disabled: Account was disabled
  • account.closed: Account was closed
  • account.update.completed: An Update finished (balance/data refreshed)

Subscriptions: Automatic Data Refresh

Instead of manually requesting Updates or Balances, you can subscribe an account to automatic refresh. When subscribed, Method periodically fetches fresh data and notifies you via webhook. See Update Subscriptions for details. The subscriptions and available_subscriptions arrays on each Account show what’s currently active and what can be enabled.

Products and the Lifecycle

Each account carries a products array — the list of Method capabilities currently available for that account. Products include: update (refresh balances/data), balance (real-time balance), payment (send funds to creditor), card_brand (card art and product name), payoff (auto loan payoff quotes), sensitive (full account numbers), attribute (credit health metrics), and payment_instrument (card tokenization). Product availability depends on three factors:
  1. Account type: card_brand only applies to credit cards, payoff only to auto loans (see Liability Types)
  2. Account status: Disabled and Closed accounts lose most products
  3. Team configuration: Some products require team-level enablement (check restricted_products)
Always check the products array before attempting an operation. Attempting an operation not in products will return an error. See the Products reference for the full list.