billingHelp

Troubleshooting

The usual suspects — payments stuck pending, no email, jobs not running, links in the wrong form, sign-in loops, uploads refused.

Where to look first#

  • Self-check — most configuration problems show up here with the fix.
  • Health & jobs — scheduler, jobs, outbox and their last errors.
  • Logs — data/logs/ (one JSON line per event). Errors shown to users carry a Reference that matches a log line.
  • Audit log — who changed what, and when.

Common problems#

Payments stay "Pending" or "Confirming your payment"#

The provider's webhook is not arriving or is refused. Check the endpoint in the provider's dashboard and its delivery log, and see When payments stay pending.

No email arrives#

Check Super → Settings → Email (transport and key set?), send a test message, and look at the outbox for the error. Check the recipient is not on the suppressed list. See Email through SMTP2GO.

Jobs do not run#

Health & jobs shows the scheduler's last tick. Without system cron, jobs run only after page views. Add the cron entry from the Server guide.

The site runs on a plain PHP vhost, or the application has not yet seen a clean URL work. Both forms are correct. For clean URLs use the hardened vhost with try_files … /index.php; the hourly routing probe notices the change.

Sign-in returns to the sign-in page#

The session cookie is not kept. With HTTPS, the base URL in data/config.php must start with https://, and the site must be opened at that exact host. Check that the server clock is right.

An upload is refused#

Logos are limited to 512 KB, dispute evidence to 5 MB, GeoIP files by PHP's upload_max_filesize. Larger GeoIP files can be copied into data/geo/ instead.

sitemap.xml or llms.txt is missing on a plain vhost#

The webroot is not writable for PHP, so the static copies were not written. See Help, search engines and AI crawlers.

A page shows "Something went wrong on our side. Reference …"#

Search data/logs/ for the reference. It names the error and where it happened.