Skip to main content

Troubleshooting and application of reCAPTCHA

Updated over 2 weeks ago

Common Errors and Remedies

1. reCAPTCHA token validation error

Symptoms:

  • A “reCAPTCHA error” message appears when making a booking or submitting a form

  • Submission is not completed.

Possible cause:

  • Failure to load reCAPTCHA script

  • Network connection problem

  • Browser settings (e.g. cookie blocking)

Remedy:

  • Reload the page

  • Try another browser

  • Turn off Private Browsing mode

  • Check your network connection

2. Script loading error

Symptoms:

  • Errors such as “Recaptcha script is not loaded” are displayed in the console

  • The reCAPTCHA function does not work

Possible causes:

  • Internet connection problem

  • Access to Google's servers is blocked

  • Interference by browser extensions

Remedy:

  • Check network connection

  • Temporarily disable browser extensions

  • Clear DNS cache

3. Score evaluation error

Symptoms:

  • Legitimate users are treated as spam

  • Or, obvious spam gets through

Possible cause:

  • Incorrect score level settings

  • False reCAPTCHA decision

Remedy:

  • Adjust the score level (lower if too strict, raise if too loose)

  • Change the filter type (e.g., from “treat as unauthorized access” to “treat as spam”)

How to check if reCAPTCHA works on booking pages and forms

To check if your reCAPTCHA settings are working properly, you can use the following methods

  1. Test booking/form submission:

    • Test booking and form submissions to make sure they are processed correctly.

    • Testing on different devices and browsers

  2. Test spam filters (for developers):

    • In the development environment, debug scores can be used to test with specific scores

    • Use the recaptchaScore parameter to verify behavior with different score values

  3. Check logging:

    • Check reCAPTCHA events in Amplitude Analytics

    • Analyze score distribution and rejection rates

Advanced Utilization Scenarios

1. Tiered security settings

If you have multiple booking pages or forms, you can set different security levels depending on the level of importance:

  • High security (forms with sensitive information):

    • Score level: 0.7 to 0.9

    • Filter type: Treat as unauthorized access

  • Standard security (general booking):

    • Score level: 0.5

    • Filter type: Treat as spam

  • Low security (general queries):

    • Score level: 0.3

    • Filter type: Treat as spam

2. Spam analysis and enhanced countermeasures

By periodically analyzing the contents of transmissions processed as spam, patterns can be identified and countermeasures can be strengthened:

  • If there are many unauthorized accesses from a specific IP address, consider IP blocking

  • If spam is concentrated during certain time periods, increase the security level only during those times

Frequently Asked Questions and Answers

Q: Will enabling the reCAPTCHA linkage affect the bookings of legitimate users?

A: At the recommended setting (score level 0.5), most legitimate users will not be affected. However, a higher score level may cause some legitimate users to be misclassified as spam.

Q: When will reCAPTCHA changes take effect?

A: Changes to your settings will take effect immediately. After the change is made, the new settings will be applied to new bookings and form responses.

Did this answer your question?