Prerequisites
Before retrying an action, record the selected payroll account, period dates, current run status, error code, and approximate time. Do not copy passwords, connection tokens, raw reports, or identifiable payroll results into a support request.
Troubleshooting
Sign-in and access
Why are no payroll accounts listed?
Your sign-in does not have active access to a payroll account. Ask an account administrator to verify your email, role, invitation, and account status.
Why can I see a run but not change it?
Your role may be read-only, the period may not be open, or the deployment may have live mutations disabled. Use the blocker displayed beside the action.
Sources and calculation
Why is Calculate disabled?
PayCanvas needs all required source data, an approved set of payroll rules, any required source-choice decisions, and calculation enabled for the account. It blocks calculation when data is missing or duplicated, employee mappings conflict, a rule is invalid, or the totals do not balance.
Should I create another run after a source failure?
Not automatically. Open Collect sources and use the offered retry, continuation, cancel, or saved-data recovery action. These paths preserve evidence and reduce duplicate provider work.
Why is the result provisional?
At least one unresolved question could change someone's pay. PayCanvas holds only the affected money and calculates the rest. Review Unresolved and choose an answer only when the source evidence supports it.
Why did the result change after resolving an item?
PayCanvas recalculates from the same locked source data and saves a new result version. The earlier result remains available, so you can compare exactly what changed.
Forecasting and outputs
Why does the forecast not match accounting revenue?
Forecasting uses provisional booked subtotals from the configured booking input, not recognized revenue, cash receipts, or settlements. It also lacks implemented operating-expense and opening-cash sources.
Why are no files available to download?
The selected period may not have calculated output files yet. Calculation or file generation may also be unavailable or blocked for the account.
Does Totals and files reviewed approve payroll?
No. It enables the reviewed-file download action only. Run locking, official approval, provider submission, email, and payment are not implemented in that surface.
MCP connector
Why does consent say membership is required?
The public payroll connector requires active account-administrator or payroll-operator access.
What does authorization_required mean?
The connection was not given permission for that optional action, or your current role cannot perform it. The failed request changes nothing.
What does invalid_token or insufficient_scope mean?
Reconnect through OAuth and verify that you used the operator endpoint. Do not reuse a token across clients or between the operator and platform endpoints.
Why was the callback rejected?
Use the client's standard ChatGPT or Claude callback, or an HTTP loopback callback on localhost or 127.0.0.1. PayCanvas rejects arbitrary remote callbacks and callbacks containing unapproved credentials, fragments, or fixed query data.
Expected result
After following the relevant section, you either return to a valid supported state or have a safe error/reference package ready for support.
Still stuck?
Do not repeatedly submit a write action after an unknown response. Refresh once, inspect the current audit or job state, then contact support.