Deposit Switch (beta) errors

Guide to troubleshooting Deposit Switch errors

INVALID_DEPOSIT_SWITCH_ID

The given deposit switch ID was invalid.
Server-Side
Common causes
  • The value provided for the deposit switch ID does not conform to the format for a valid deposit switch ID.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "DEPOSIT_SWITCH_ERROR",
"error_code": "INVALID_DEPOSIT_SWITCH_ID",
"error_message": "deposit switch id was invalid",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

DEPOSIT_SWITCH_NOT_FOUND

A deposit switch with the given ID was not found.
Server-Side
Common causes
  • An invalid deposit switch ID was provided.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "DEPOSIT_SWITCH_ERROR",
"error_code": "DEPOSIT_SWITCH_NOT_FOUND",
"error_message": "deposit switch not found",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

DEPOSIT_SWITCH_TOKEN_NOT_FOUND

The given deposit switch token was not found.
Server-Side
Common causes
  • An invalid deposit switch token was provided.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "DEPOSIT_SWITCH_ERROR",
"error_code": "DEPOSIT_SWITCH_TOKEN_NOT_FOUND",
"error_message": "deposit switch token expired",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

DEPOSIT_SWITCH_INVALID_ACCOUNT

The target account cannot be used to create a deposit switch.
Server-Side
Common causes
  • The account specified is not a depository (checking or savings) account.
  • Plaid was unable to find any owner contact information (such as email or phone) associated with the account.
  • Plaid was unable to retrieve an account number and routing number for the account.
  • The account has no name.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "DEPOSIT_SWITCH_ERROR",
"error_code": "DEPOSIT_SWITCH_INVALID_ACCOUNT",
"error_message": "invalid deposit switch target account field (fieldname): (requirements)",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

DEPOSIT_SWITCH_VALID_AUTH_NOT_FOUND

The target account does not have Auth data.
Server-Side
Common causes
  • Link was not initialized with the Auth product for the given Item.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "DEPOSIT_SWITCH_ERROR",
"error_code": "DEPOSIT_SWITCH_VALID_AUTH_NOT_FOUND",
"error_message": "target account is missing account and routing numbers",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

DEPOSIT_SWITCH_VALID_IDENTITY_NOT_FOUND

The target account does not have Identity data.
Server-Side
Common causes
  • Link was not initialized with the Identity product for the given Item.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "DEPOSIT_SWITCH_ERROR",
"error_code": "DEPOSIT_SWITCH_VALID_IDENTITY_NOT_FOUND",
"error_message": "target account is missing account and routing numbers",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

DEPOSIT_SWITCH_ALREADY_COMPLETED

A token creation was attempted on a switch that has already completed.
Server-Side
Common causes
  • A token creation was attempted on a switch that has already completed.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "DEPOSIT_SWITCH_ERROR",
"error_code": "DEPOSIT_SWITCH_ALREADY_COMPLETED",
"error_message": "cannot generate token because deposit switch associated with this deposit switch id has already been completed",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}