Onboard an employee through the MyZen app
Complete your own payroll onboarding for Zenoti Integrated Payroll (ZIP) directly through the myZen app. This article is for employees completing self-service onboarding. If you are an administrator entering data on behalf of an employee, use the web-app onboarding flow instead.
Before you begin
- Your employer must be enrolled in ZIP with the correct center mapping and your employment type (Regular or Contractor) already configured.
- You need the myZen app installed on your mobile device and sign-in credentials for it.
- Use the web app instead if your employer prefers admin-driven onboarding. Both surfaces write to the same payroll record; you can finish on either one if you start on the other.
What you'll need
Have these ready before you start so you can complete onboarding in one sitting:
- Social Security Number (SSN). 9 digits, formatted
xxx-xx-xxxx. If you are a contractor classified as a business, you may use your business EIN instead. - Government-issued photo ID (W-2 employees only — used for I-9 employment-eligibility verification). Driver's license, U.S. passport, or other I-9-accepted ID.
- U.S. residential address. Billing address required. Shipping address required only if different from billing.
- Bank routing number and account number for the account that will receive your direct deposit. Alternatively, if you already have a Zenoti wallet, you can deposit to that instead.
- Sign-in credentials for the myZen app provided by your employer.
If you don't have all of these, you can start the flow and save partial progress. Return later to complete the remaining sections.
Steps
- Open the myZen app and sign in.
- Go to Menu > Payroll Details.
- Complete the following sections in any order:
- Personal details — Verify your legal first name, legal last name, billing address, shipping address (if different), phone, and email. Anchor: required fields.
- Bank account — Add the bank account that will receive your direct deposit. Choose instant verification (links your bank via Plaid; verification completes in seconds for supported banks) or manual verification (you receive two small microdeposits over 1–3 business days; you enter the amounts to verify). Alternatively, deposit to your Zenoti wallet.
- Tax withholdings — If you are a Regular (W-2) employee, complete a W-4. If you are a Contractor, complete a W-9. Contractors classified as a business can choose to use a business EIN instead of an SSN.
- Delivery preferences — Choose how you receive paystubs and tax documents (email, in-app, or both).
- Submit the completed onboarding. You'll see a confirmation in the app when all sections are finished.
W-2 vs Contractor (1099) onboarding differences
The required fields are the same, but the tax-form path diverges based on the employment type your employer set for you:
| Aspect | Regular (W-2) | Contractor (1099) |
|---|---|---|
| Tax form completed | W-4 (federal withholding) | W-9 |
| I-9 (employment-eligibility verification) | Required | Not required |
| Identity input | SSN | SSN OR business EIN (for business-classified contractors) |
| Withholding calculation | Federal + state withholding deducted from each paycheck | No withholding — you are responsible for your own tax payments |
Tax-form generation (the actual W-4, W-9, I-9 PDFs you sign in the app) and the per-state withholding calculation are handled by Check Technologies as the payroll engine. for the per-state W-4 supplemental form catalog and contractor 1099 reporting schedule.
If bank verification fails
The status of your bank account during onboarding comes from BankAccountStatusEnum (fintech-ms-payroll/Payroll.Domain/Models/Employee/). Common failures and recovery actions:
| Status | What it means | What to do |
|---|---|---|
| Plaid link failed | Your bank is not in Plaid's supported-bank list, or you cancelled the Plaid sign-in. | Switch to manual verification: enter your routing and account number directly. ZIP will send two small microdeposits over 1–3 business days. |
| Microdeposit verification failed | The amounts you entered did not match the microdeposits. | Wait for the deposits to actually arrive in your account (1–3 business days), then re-enter the exact dollar amounts. |
| Account not eligible for direct deposit | Some account types (savings without ACH, certain prepaid cards) are not eligible. | Use a checking account or savings account that supports ACH. |
| Routing number invalid | The 9-digit routing number is incorrect. | Double-check the routing number on a check, in your bank's mobile app, or with your bank directly. |
| Repeated failures | After 3+ retries, the bank may be on Check Technologies' unsupported list. | Contact support@zenoti.com (include your name and FEIN) to confirm whether your bank is supported. |
The list of banks that Check Technologies does and does not support, the exact microdeposit verification window, and underlying Plaid integration details are owned by Check Technologies. for the unsupported-bank list and Plaid integration reference.
If your SSN does not match agency records
During tax setup, Check Technologies validates your Social Security Number (SSN) against agency records. If your SSN does not match — for example, the digits were entered incorrectly, or your name on file with the Social Security Administration does not match the name you entered — onboarding pauses until the mismatch is resolved.
When this happens:
- Re-check the SSN you entered. Compare digit-by-digit against your physical Social Security card. Common errors include transposed digits or substituting a number from your driver's license.
- Re-check the name you entered. The first, middle, and last name must match exactly what appears on your Social Security card, including any suffix (Jr., Sr., II, III).
- If the SSN and name on the card match what you entered, but onboarding still pauses, email
support@zenoti.comwith your name, FEIN, the employee record ID, and a brief description of the mismatch (do not include the SSN in the email). The Zenoti Payroll team coordinates with Check Technologies to clear the validation hold once the underlying record is corrected with the Social Security Administration. - While the mismatch is under review, your onboarding stays at the KYC pending stage. Payroll runs for the affected pay period proceed for other employees; your record is excluded until the mismatch clears.
If your legal name changed (marriage, court order, etc.) and the Social Security Administration record has not yet been updated, complete Form SS-5 with the SSA first, then return to the onboarding flow once the SSA confirms your record. The SSA, not Zenoti, owns the record-update process.