Account & Access Issues

Last updated: February 2, 2026

Common Account Errors

		Error CodeErrorDescription
500001	`INVALID_ACCOUNT_DATA`	Invalid bank account data provided
500301	`ACCOUNT_NOT_FOUND`	Bank account ID not found
500501	`INACTIVE_ACCOUNT`	Bank account is not active

Authentication Errors

		CodeErrorDescription
200001	`INVALID_API_KEY`	Invalid API key
200201	`PRODUCTION_NOT_ENABLED`	Production is not enabled for this profile
200202	`USER_ROLE_NOT_ALLOWED`	User role not allowed to perform this action
200203	`UNAUTHORIZED`	Unauthorized
200204	`PROFILE_FROZEN`	Profile is not authorized to access this resource
200301	`BILLING_CONFIG_NOT_FOUND`	Billing configuration not found
200301	`KEY_DOES_NOT_EXIST`	Key does not exist

phone number should include +area code

User Account Issues

		CodeErrorDescription
300001	`USER_ALREADY_EXISTS`	User already exists
300201	`USER_ACTION_NOT_ALLOWED`	User is not allowed to perform this action
300201	`USER_COMPLIANCE_VERIFICATION_FAILED`	User compliance information is not approved
300202	`USER_COMPLIANCE_DATA_INVALID`	User compliance data is invalid
300202	`USER_FROZEN`	User is not authorized to access this resource
300301	`USER_NOT_FOUND`	User not found

Troubleshooting Tips

Account not found: Verify the accountId is correct and belongs to the specified user
Inactive account: Reactivate the account or create a new one
User frozen: Contact HIFI support to resolve compliance or security holds
Invalid account data: Check required fields (routing number, account number, beneficiary details)