When creating an account for a worker, the process may fail for a variety of reasons. The tables below outline the best practices for navigating the various statuses and failure reasons.
Create Account Statuses (Pay Admin)
|Account Status||Description||Suggested Action|
|VERIFIED||The wallet has been created (account/routing numbers have been generated) but the worker has not yet claimed the wallet.
||Worker to use onboarding link to start the sign up process in the Branch App.
|FAILED||The wallet has not been created yet due to a non-recoverable failure.||Check FAILED reason codes table below with suggested action.|
|SETUP COMPLETE||The user has claimed the wallet and setup is complete.||Account is fundable and ready for payment.|
|PENDING||The account creation process has started.||
If status remains pending for more than 1 business day, contact Branch Admin Support.
|USER VERIFICATION REQUIRED||Information submitted requires additional review.||Worker to use onboarding link to complete verification in-app and upload documents.|
|CANCELED||The request was manually aborted due to an unexpected error or invalid user data provided.||Retry creating the account with corrected information.|
|PENDING REVIEW||The account creation process has started, and the information provided is under review.||Review can take 1-5 business days. Wait on approval or declined status in Pay Admin.|
Failed Status Reason Codes
Click into a worker’s failed account creation in Pay Admin to view the reason code.
|Reason Code||Description||Suggested Action|
|ACCOUNT_SUSPENDED||The user account exists but is currently suspended.||Contact Branch Admin Support to resolve if needed.|
A wallet already exists for the email address provided. The user may already have an account.
Check email address and SSN and verify both are correct. If incorrect, fix and retry request. If correct, contact Branch Admin Support.
|KYC_SSN_INVALID||The SSN is invalid.||
Inform user that the SSN provided is invalid and correct the information. Retry with corrected information.
|KYC_PII_SSN_MISMATCH||The personal information does not match the SSN provided.||
Verify all user information is correct and matches government ID. Retry with corrected information. If errors persist, contact Branch Admin Support.
|KYC_PO_BOX_NOT_ALLOWED||PO Box was entered as address. Physical address is required.||
Inform user PO Box isn’t allowed and request to provide a valid address. Retry with corrected information.
|KYC_DECEASED||The information provided matched to a person who is deceased.||
Verify all user information is correct and matches government ID. Retry with corrected information.
|EMPLOYEE_UNDER_AGE||The requested employee’s date of birth did not meet minimum age requirements (14+).||
Check the DOB and verify it is correct. If incorrect, retry with corrected information.
|EMPLOYEE_ALREADY_LINKED||The requested employeeId is already linked to an active account.||
Visit the organization > workers tab within Pay Admin to view the account that is already enrolled with this ID. Verify if the correct account is enrolled. If correct, the worker is already successfully enrolled. If incorrect, revoke access and retry creating the account.
|Retry with same information. Contact Branch Admin Support if issue persists.|
||The worker's account requires manual review.||Contact Branch Admin Support with worker details. In some cases, these may not be overturned.|
Onboarding Link Delivery
Once a worker's account is created and in the VERIFIED status, a user-specific onboarding link is generated and is sent via email and text message to the worker. The onboarding link can also be viewed in the Branch Pay Admin Portal.
Onboarding Link Sender Contacts:
- SMS: +1 612-662-4975
- Email: firstname.lastname@example.org
Tips & Tricks:
- Be sure to check spam & junk folders.
- You can pull onboarding link from the Pay Admin Portal and share with the worker as needed.