Help & privacy
The most common pitfalls with their fix, and what CaptchaCore stores about your visitors.
On this page
Troubleshooting
Widget lädt nicht / 500 auf /api/v2/challenge
Domain prüfen: Ist die Domain in den Site-Einstellungen unter "Erlaubte Domains" eingetragen? Wildcards möglich: *.example.com
CORS-Fehler im Browser
Der CaptchaCore-Service muss die anfragende Domain kennen. Domain in den Site-Einstellungen hinzufügen. Widget-JS und Worker-JS werden mit Access-Control-Allow-Origin: * ausgeliefert.
Token ist null / leer
Das Widget-Script muss vor dem Formular-Submit geladen sein. Prüfe: Ist data-captchacore auf dem <form>? Ist data-captchacore-widget Container vorhanden (für visible/interactive)?
PoW FAIL / Nonce FAIL
Der Nonce ist 5 Minuten gültig und einmalig verwendbar. Wenn der User zu lange wartet oder doppelt absendet, schlägt die Verifikation fehl. Seite neu laden.
Checkbox-Haken nicht sichtbar
Externe CSS-Frameworks können das SVG überschreiben. Das Widget nutzt !important für alle kritischen Styles. Bei Problemen: Browser-DevTools > Elements > Computed Styles prüfen.
Risk Score zu hoch für echte User
Behavioral-Schwellwerte prüfen: time_to_submit_ms unter 1500ms = +35 Penalty. User muss genug Zeit auf der Seite verbringen und interagieren.
Privacy (GDPR)
What is stored
- IP hash (daily salt)
- Anonymized IP (last octet zeroed)
- Country code (2 letters)
- User-Agent hash
- Risk score + result
- Automatic deletion (default: 30 days)
What is NOT stored
- No plain-text IPs
- No cookies (except UAM)
- No mouse trajectories
- No keystrokes
- No form data
- No external requests