> For the complete documentation index, see [llms.txt](https://docs.zebec.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zebec.io/zebec-application-suite/enterprise-payroll/troubleshooting.md).

# Troubleshooting

## "My invite code expired"

Invite codes expire after 7 days. Your employer can resend a new code from their dashboard. Reach out to your contact at the company.

## "I can't connect my wallet"

1. **Make sure your wallet is unlocked.** Open the wallet app first, then try again.
2. **Make sure you're on the right chain.** If your employer is disbursing on Solana, your wallet needs to be on Solana.
3. **Try a different browser.** Wallet extensions sometimes conflict with each other.
4. **Refresh the page.** Especially after installing a new wallet.

Still stuck? Contact <support@zebec.io> with your invite code and the wallet you are trying to use.

## "My payroll run is stuck"

Active payroll runs occasionally pause if:

* **The treasury is underfunded.** Top up and the run resumes automatically.
* **The signing wallet is disconnected.** Reconnect from **Settings → Treasury → Signers**.
* **An employee or contractor's wallet address is invalid.** The dashboard will flag which payee. Correct the address with them, then retry that individual payment.

If none of the above apply, check the dashboard alerts panel or reach out to support.

## "An employee or contractor didn't receive their pay"

Check the payee's row in the payroll run. Status will show one of:

* **Completed** — pay arrived. Ask them to check their wallet.
* **Pending** — still processing, usually clears within minutes.
* **Failed** — flagged for retry. Common causes: invalid wallet address, or the payee had not completed onboarding.

If the status shows Completed but the payee says they do not see it, share the transaction hash so they can verify it on the corresponding chain's block explorer.

## "I'm an employee/contractor and I missed a pay cycle"

Cycles only execute if your onboarding is complete (invite code claimed, email verified, wallet connected). If you joined mid-cycle, your first payout will be pro-rated on the next cycle close.

If you have completed onboarding and a cycle still passed without pay, contact your employer first. They can see your status in their dashboard. If the issue is on Zebec's end, escalate to <support@zebec.io>.