Request Errors

The request to the /accounts/:acc_id endpoint failed. These are the sub_type that can be returned.

INVALID_REQUEST

The request body failed basic validation for the specific API endpoint.

NOT_FOUND

The requested resource does not exist.

INVALID_HOLDER_ID

The provided holder_id does not match an existing entity.

Consent for this account has already been withdrawn.

Consent for this account has already been granted.

ACCOUNT_HAS_PAYMENT_IN_PROGRESS

Consent for this account cannot be withdrawn as it has one or more associated payments in progress.


Resource Errors

Errors set on an Account’s error property for processes that are unsuccessful.

11001 – ACCOUNT_INVALID_DETAILS

The details on the Account are invalid as reported by the FI.

Causes

  • Incorrect Account information - the account number or routing number is incorrect.
  • The Account could not be located.
{
  "type": "ACCOUNT_DISABLED",
  "code": 11001,
  "sub_type": "ACCOUNT_INVALID_DETAILS",
  "message": "Account was disabled due to invalid information reported by the financial institution."
}

Resolution

The Account will be disabled and all its capabilities will be removed.


11002 – ACCOUNT_CLOSED

The Account has been closed.

Causes

  • Account is closed.
{
  "type": "ACCOUNT_DISABLED",
  "code": 11002,
  "sub_type": "ACCOUNT_CLOSED",
  "message": "Account was disabled due to a closure in the underlying bank account."
}

Resolution

The account will be disabled and all its capabilities will be removed.


11003 – ACCOUNT_UNAUTHORIZED_PAYMENT

The holder of the Account did not authorize a payment.

Causes

  • A payment was stopped by the Account holder because they didn’t authorize the payment.
{
  "type": "ACCOUNT_DISABLED",
  "code": 11003,
  "sub_type": "ACCOUNT_UNAUTHORIZED_PAYMENT",
  "message": "Account was disabled due to a payment reported as unauthorized by the financial institution."
}

Resolution

The account will be disabled and all its capabilities will be removed.


The holder of the Account withdrew consent.

Causes

  • Account consent was withdrawn.
{
  "type": "ACCOUNT_DISABLED",
  "code": 11004,
  "sub_type": "ACCOUNT_DISABLED_CONSENT_WITHDRAWN",
  "message": "Account was disabled due to consent withdrawal."
}

Resolution

The account will be disabled and all its capabilities will be removed.


11005 – ACCOUNT_DISABLED_INVALID_STATE

The underlying liability is in an invalid state.

Causes

  • The underlying liability is in an unexpected state.
{
  "type": "ACCOUNT_DISABLED",
  "code": 11005,
  "sub_type": "ACCOUNT_DISABLED_INVALID_STATE",
  "message": "Account was disabled due to an invalid state in the underlying liability."
}

Resolution

The account will be disabled and all its capabilities will be removed.