Captcha.solve returns an error.
Before you start
BLS is available on reserved plans only. Ask support to set it up for your account; they send the start settings it needs.Automatic captcha solving
Use the Playwright or Puppeteer lifecycle with the start settings from support. The solver starts by itself, and BLS sends no solve events, so wait for the portal’s next step:BLS challenge
BLS captchas typically show up at three points in the booking flow: checking appointment availability, submitting applicant details, or continuing through a protected booking step. The exact trigger point varies by portal — the same regional site can ask for it more than once in a single session. The challenge itself is a 3×3 number grid with distorted, noisy, or color-shifted digits — a static OCR-style puzzle, not a behavioral or token-based check like reCAPTCHA or Turnstile. This means detection and solving both work differently here: there’s no score to interpret and no widget state to watch, just an image to read. BLS runs separate regional portals — Spain, Italy, Hungary, Portugal, and others — each under its own domain, but the captcha format and the setup are the same across them.BLS portal sessions commonly time out after 15–20 minutes of inactivity, and some regional sites clear the form on a failed captcha attempt rather than just reprompting. Budget for that when setting timeouts — a slow solve can cost more than the captcha attempt itself if it triggers a session reset.
Verify bypass worked
The BLS solver answers the challenge on the page. It does not book appointments or complete the surrounding form. Continue those steps in your automation after the site accepts verification. Keep the CDP connection open while solving. Avoid running a second solver against the same challenge. If verification completes but the page is still blocked, inspect the next network response or form validation error.Troubleshooting
If nothing happens, confirm that the browser was started with the settings from support and the challenge is present. BLS sends no failure events. See CAPTCHA troubleshooting for shared errors and DevTools to inspect a running attempt. Stop the browser after the job completes.BLS captcha FAQ
Can I send BLS to Captcha.solve for manual solving?
Can I send BLS to Captcha.solve for manual solving?
No. BLS is solved only on its own, when the page loads. Sending
"bls" to Captcha.solve returns an error; there is no manual solving path for this type.Does the same code work across different BLS country portals?
Does the same code work across different BLS country portals?
Yes. Spain, Italy, Hungary, Portugal, and other regional BLS sites use the same captcha format, so the same setup applies regardless of which portal you’re automating.
Why does the captcha keep reappearing during a single booking session?
Why does the captcha keep reappearing during a single booking session?
BLS can trigger the challenge at more than one step — availability checks, form submission, and final confirmation are common trigger points, and some portals reprompt at each one rather than once per session.
Why does {'status': 'started'} not mean the job succeeded?
Why does {'status': 'started'} not mean the job succeeded?
BLS does not need
Captcha.autoSolve, and it sends no solve events: the solver works on its own. Wait for the portal’s next step before treating the job as done.