Troubleshooting

Quick fixes for common issues (payments, email sending, and loading problems).

7 min read

Last updated 2026-02-03

Before you do anything

Hard refresh your browser.

Log out and back in if your session looks stale.

If you’re on localhost/dev: restart the dev server to clear HMR issues.

If Pay Now fails: confirm the active provider is connected and credentials are saved.

If you get authentication errors: verify Test vs Live mode matches the keys you entered.

If invoice status doesn’t update: this is usually webhook/provider dependent — check PayGate docs and provider settings.

PayGate webhook endpoint (Stripe / generic)

If you’re setting up Stripe webhooks, point Stripe to this endpoint.

https://www.illumi.co.za/api/webhooks/paygate

If a PDF looks blank: try downloading again and confirm your browser isn’t blocking it.

If the printed invoice is clipped: use the Preview/PDF layout and avoid browser scaling that cuts off the bottom.

Troubleshooting checklist

Check 1

Hard refresh

Check 2

Confirm settings

When to contact support

If you can reproduce the issue consistently, include screenshots and steps.

Invoice number and workspace name.

Which provider you used (PayFast/Stripe/Stitch/etc).

Screenshot of the error + the time it occurred.

Whether PayGate was set to Test or Live mode.

Tip

If the issue is payment-related, include whether you clicked Pay Now from Preview, from an emailed link, or from the public pay page.