Account Verification Session Errors

Request Errors

The request to the /accounts/{acc_id}/verification_sessions 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.

`EXISTING_VERIFIED_SESSION`

The Account has already been verified.

`EXISTING_VERIFICATION_SESSION`

The Account has an existing verification session.

`VERIFICATION_SESSION_ATTEMPT_LIMIT_REACHED`

The verification session attempt limit has been reached.

`VERIFICATION_MAX_LIMIT_BY_TYPE_REACHED`

The maximum number of attempts for this verification type has been reached.

`VERIFICATION_MAX_TOTAL_LIMIT_REACHED`

The maximum number of attempts across all verification types has been reached.

Legacy verification request errors

The following sub_type values are returned by the legacy /accounts/{acc_id}/verification endpoints.

`EXISTING_VERIFICATION`

A verification already exists for this account.

`INVALID_ACCOUNT_TYPE`

The Account must be of type ach.

`INVALID_VERIFICATION_AMOUNTS`

The verification amounts provided are invalid.

`INVALID_VERIFICATION_STATUS`

The verification must be in pending status.

`INVALID_VERIFICATION_TYPE`

The verification type provided is invalid.

`VERIFICATION_DISABLED`

Verification for this account has been disabled. You can no longer verify this account.

Resource Errors

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

`16001 – VERIFICATION_TYPE_NOT_SUPPORTED`

The AccountVerificationSession has failed.

Causes

The inputted verification type is not supported for the merchant.

{
  "type": "ACCOUNT_VERIFICATION_SESSION_FAILED",
  "code": 16001,
  "sub_type": "VERIFICATION_TYPE_NOT_SUPPORTED",
  "message": "The verification type provided is not supported for the merchant."
}

Resolution

Initiate a new AccountVerificationSession with a supported type.

`16002 – INVALID_DETAILS`

The AccountVerificationSession has failed due to incorrect details.

Causes

The details required to pass verification was incorrect.

{
  "type": "ACCOUNT_VERIFICATION_SESSION_FAILED",
  "code": 16002,
  "sub_type": "INVALID_DETAILS",
  "message": "The provided details are invalid for the account."
}

Resolution

Initiate a new AccountVerificationSession and verify the correct details is provided.

`16003 – VERIFICATION_SESSION_ATTEMPT_LIMIT_REACHED`

The AccountVerificationSession has failed due to reaching maximum number of attempts for this session.

Causes

Too many failed verification attempts for this session.

{
  "type": "ACCOUNT_VERIFICATION_SESSION_FAILED",
  "code": 16003,
  "sub_type": "VERIFICATION_SESSION_ATTEMPT_LIMIT_REACHED",
  "message": "The maximum number of attempts has been reached for this account verification session."
}

Resolution

Initiate a new AccountVerificationSession.

`16004 – MICRO_DEPOSITS_FAILED`

The AccountVerificationSession has failed due to invalid account information.

Causes

Incorrect Account information - the account number or routing number is incorrect.
The Account could not be located.

{
  "type": "ACCOUNT_VERIFICATION_SESSION_FAILED",
  "code": 16004,
  "sub_type": "MICRO_DEPOSITS_FAILED",
  "message": "The micro-deposits failed to verify due to invalid account information."
}

Resolution

The verification session has failed and the Account will be disabled.

Legacy Verification Resource Errors

Errors set on the legacy /accounts/{acc_id}/verification resource’s error property.

`13001 – ACCOUNT_VERIFICATION_ATTEMPT_LIMIT_REACHED`

The legacy account verification was disabled after reaching the maximum number of attempts.

{
  "type": "ACCOUNT_VERIFICATION_DISABLED",
  "code": 13001,
  "sub_type": "ACCOUNT_VERIFICATION_ATTEMPT_LIMIT_REACHED",
  "message": "Account verification was disabled due to the maximum verification limit (5) being reached."
}

`13002 – ACCOUNT_VERIFICATION_DEPOSITS_FAILED`

The legacy account verification was disabled because micro-deposits failed.

{
  "type": "ACCOUNT_VERIFICATION_DISABLED",
  "code": 13002,
  "sub_type": "ACCOUNT_VERIFICATION_DEPOSITS_FAILED",
  "message": "Account verification was disabled due to the failure of micro-deposits to an invalid account."
}

​Request Errors

​INVALID_REQUEST

​NOT_FOUND

​EXISTING_VERIFIED_SESSION

​EXISTING_VERIFICATION_SESSION

​VERIFICATION_SESSION_ATTEMPT_LIMIT_REACHED

​VERIFICATION_MAX_LIMIT_BY_TYPE_REACHED

​VERIFICATION_MAX_TOTAL_LIMIT_REACHED

​Legacy verification request errors

​EXISTING_VERIFICATION

​INVALID_ACCOUNT_TYPE

​INVALID_VERIFICATION_AMOUNTS

​INVALID_VERIFICATION_STATUS

​INVALID_VERIFICATION_TYPE

​VERIFICATION_DISABLED

​Resource Errors

​16001 – VERIFICATION_TYPE_NOT_SUPPORTED

​Causes

​Resolution

​16002 – INVALID_DETAILS

​Causes

​Resolution

​16003 – VERIFICATION_SESSION_ATTEMPT_LIMIT_REACHED

​Causes

​Resolution

​16004 – MICRO_DEPOSITS_FAILED

​Causes

​Resolution

​Legacy Verification Resource Errors

​13001 – ACCOUNT_VERIFICATION_ATTEMPT_LIMIT_REACHED

​13002 – ACCOUNT_VERIFICATION_DEPOSITS_FAILED

Request Errors

`INVALID_REQUEST`

`NOT_FOUND`

`EXISTING_VERIFIED_SESSION`

`EXISTING_VERIFICATION_SESSION`

`VERIFICATION_SESSION_ATTEMPT_LIMIT_REACHED`

`VERIFICATION_MAX_LIMIT_BY_TYPE_REACHED`

`VERIFICATION_MAX_TOTAL_LIMIT_REACHED`

Legacy verification request errors

`EXISTING_VERIFICATION`

`INVALID_ACCOUNT_TYPE`

`INVALID_VERIFICATION_AMOUNTS`

`INVALID_VERIFICATION_STATUS`

`INVALID_VERIFICATION_TYPE`

`VERIFICATION_DISABLED`

Resource Errors

`16001 – VERIFICATION_TYPE_NOT_SUPPORTED`

Causes

Resolution

`16002 – INVALID_DETAILS`

Causes

Resolution

`16003 – VERIFICATION_SESSION_ATTEMPT_LIMIT_REACHED`

Causes

Resolution

`16004 – MICRO_DEPOSITS_FAILED`

Causes

Resolution

Legacy Verification Resource Errors

`13001 – ACCOUNT_VERIFICATION_ATTEMPT_LIMIT_REACHED`

`13002 – ACCOUNT_VERIFICATION_DEPOSITS_FAILED`