Documentation

Troubleshooting

Common integration failures and the first checks to make.

common failures

  • hostname mismatch: add the frontend hostname to the site allowlist.
  • server verify fails: use the secret key, not the site key.
  • proof replay: every proof token is single-use.
  • expired challenge: refresh and collect a new answer.
  • WordPress submit race: wait for captcha.verify() before the form submits.

official references