BILLER_ACCOUNT_LOCKED

Cause

The biller locked the end-user’s account after too many sign-in attempts. The stored credential is correct and was not revoked — the lock is a biller-side account state, not a wrong password.

How to fix it

The user must clear the lock at the biller (reset their password, or contact biller support), then reconnect. Retrying with the same credentials will not clear the lock.

Example response

{
  "error_code": "BILLER_ACCOUNT_LOCKED",
  "error_type": "invalid_request",
  "error_message": "The biller locked the account.",
  "hint": "The user must clear the lock at the biller (reset their password, or contact biller support), then reconnect. Retrying with the same credentials will not clear the lock.",
  "docs_url": "https://docs.billerapi.com/errors/BILLER_ACCOUNT_LOCKED",
  "request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}

Related

• Error handling — the error envelope shape and how to parse it
• Error code reference — every stable error code