
Adélia Cruz
Neural Network Developer

Pesan verifikasi reCAPTCHA gagal menghentikan pengguna di tengah formulir, login, atau checkout. Kesalahan ini dipicu oleh mesin analisis risiko Google ketika tidak dapat memverifikasi permintaan berasal dari manusia. Untuk pengguna akhir, perbaikannya biasanya pengaturan browser. Untuk pengembang yang membangun scraper, alat RPA, atau pipeline pengujian otomatis, masalahnya lebih dalam. Panduan ini mencakup kedua skenario. Anda akan menemukan penyebab akar kesalahan verifikasi Google reCAPTCHA, proses perbaikan langkah demi langkah secara manual, dan panduan untuk menangani reCAPTCHA secara programatis menggunakan API CapSolver — dengan kode nyata yang dapat Anda jalankan hari ini.
reCAPTCHA adalah layanan keamanan Google yang melindungi situs web dari penyalahgunaan otomatis. Ini hadir dalam tiga versi utama:
| Versi | Cara Kerja | Interaksi Pengguna |
|---|---|---|
| reCAPTCHA v2 | Tantangan kotak centang + teka-teki gambar | Kotak centang atau grid gambar yang terlihat |
| reCAPTCHA v3 | Skoring latar belakang (0,0–1,0) | Tidak ada — sepenuhnya tidak terlihat |
| reCAPTCHA Enterprise | Sinyal risiko lanjutan + ambang batas kustom | Dapat dikonfigurasi |
Ketika layanan tidak dapat memverifikasi permintaan sah, ia mengembalikan respons verifikasi reCAPTCHA gagal. Ini bisa terjadi di sisi klien (masalah browser) atau sisi server (kunci tidak cocok, skor terlalu rendah, token kedaluwarsa).
Memahami lapisan mana kegagalan berasal adalah langkah pertama untuk memperbaikinya. Sebagai contoh, skor di bawah ambang batas dalam v3 akan menghasilkan hasil verifikasi reCAPTCHA gagal Google bahkan jika pengguna menyelesaikan tantangan dengan benar. Anda dapat membaca lebih lanjut tentang cara kerja skoring di panduan ini tentang ambang batas skor reCAPTCHA v3 dan artinya.
Berikut adalah alasan paling umum munculnya kesalahan verifikasi reCAPTCHA gagal:
Setiap penyebab ini menghasilkan mode kegagalan yang berbeda. Perbaikannya bergantung pada yang berlaku untuk situasi Anda.
Ikuti langkah-langkah ini dalam urutan. Setiap satu menargetkan penyebab tertentu dari kesalahan verifikasi reCAPTCHA gagal.
Tujuan: Menghapus data sesi yang usang yang mengganggu widget reCAPTCHA.
Tindakan:
Catatan: Restart browser sepenuhnya setelah menghapus. Jangan hanya tutup tab.
Tujuan: reCAPTCHA tidak dapat dimuat tanpa JavaScript. Ini adalah keharusan.
Tindakan:
about:config di bilah alamat → cari javascript.enabled → setel ke true.Catatan: Jika Anda menggunakan ekstensi pemblokir skrip (NoScript, uMatrix), tambahkan google.com dan gstatic.com ke daftar izin.
Tujuan: Banyak pemblokir iklan menandai skrip reCAPTCHA sebagai pelacak dan secara diam-diam menghapusnya.
Tindakan: Nonaktifkan semua ekstensi browser sementara, muat ulang halaman, dan uji formulir lagi.
Catatan: Jika kesalahan menghilang, aktifkan ekstensi satu per satu untuk mengidentifikasi penyebabnya. Tambahkan recaptcha.net dan gstatic.com ke daftar izin Anda.
Tujuan: Kunci situs yang didaftarkan untuk example.com akan menghasilkan kesalahan verifikasi reCAPTCHA gagal di staging.example.com.
Tindakan:
Catatan: Setelah memperbarui kunci, redeploy kode frontend Anda. HTML yang disimpan cache mungkin masih merujuk pada kunci lama.
Tujuan: VPN dan firewall perusahaan dapat memblokir permintaan ke www.google.com/recaptcha dan www.gstatic.com.
Tindakan: Putuskan dari VPN, beralih ke jaringan berbeda (misalnya, hotspot seluler), dan coba lagi.
Catatan: Jika kesalahan hanya terjadi di jaringan perusahaan, mintalah tim IT Anda untuk mendaftarkan *.google.com dan *.gstatic.com ke daftar izin.
Tujuan: Validasi token bersifat sensitif terhadap waktu. Jam yang lebih dari beberapa menit terlambat akan menyebabkan penolakan token.
Tindakan:
sudo timedatectl set-ntp trueCatatan: Ini adalah penyebab langka tetapi layak diperiksa jika semua langkah lain gagal.
Perbaikan manual bekerja untuk pengguna akhir. Pengembang yang menjalankan skrip otomatis menghadapi masalah berbeda: kode mereka memicu reCAPTCHA secara desain, dan respons verifikasi reCAPTCHA gagal menghentikan seluruh alur kerja.
Cara yang benar adalah mengintegrasikan API penyelesaian CAPTCHA yang menangani tantangan secara programatis dan mengembalikan token yang valid yang dapat Anda kirimkan. CapSolver mendukung reCAPTCHA v2, v3, dan Enterprise dengan waktu respons hingga 0,2 detik.
pip install requests
Tidak diperlukan SDK tambahan. API CapSolver menggunakan permintaan HTTP standar.
Kode berikut menggunakan tipe tugas resmi CapSolver ReCaptchaV2TaskProxyLess untuk tantangan reCAPTCHA v2. Lihat panduan lengkap menyelesaikan reCAPTCHA v2 untuk varian berbasis proxy dan parameter tambahan.
import requests
import time
API_KEY = "YOUR_CAPSOLVER_API_KEY"
WEBSITE_URL = "https://example.com"
WEBSITE_KEY = "YOUR_RECAPTCHA_SITE_KEY"
def create_task():
payload = {
"clientKey": API_KEY,
"task": {
"type": "ReCaptchaV2TaskProxyLess",
"websiteURL": WEBSITE_URL,
"websiteKey": WEBSITE_KEY
}
}
response = requests.post(
"https://api.capsolver.com/createTask",
json=payload
)
return response.json().get("taskId")
def get_task_result(task_id):
payload = {
"clientKey": API_KEY,
"taskId": task_id
}
while True:
response = requests.post(
"https://api.capsolver.com/getTaskResult",
json=payload
)
result = response.json()
if result.get("status") == "ready":
return result["solution"]["gRecaptchaResponse"]
elif result.get("status") == "failed":
raise Exception("Task failed: " + str(result.get("errorDescription")))
time.sleep(3)
task_id = create_task()
token = get_task_result(task_id)
print("Token yang diselesaikan:", token)
# Kirim `token` sebagai nilai `g-recaptcha-response` dalam formulir POST Anda
Ketika situs menggunakan reCAPTCHA v3, skor rendah adalah penyebab paling umum dari hasil verifikasi reCAPTCHA gagal. Gunakan tipe tugas ReCaptchaV3TaskProxyLess dan kirimkan pageAction yang benar untuk sesuai dengan yang diharapkan halaman target.
import requests
import time
API_KEY = "YOUR_CAPSOLVER_API_KEY"
WEBSITE_URL = "https://example.com"
WEBSITE_KEY = "YOUR_RECAPTCHA_V3_SITE_KEY"
PAGE_ACTION = "submit" # sesuaikan dengan string tindakan yang digunakan di halaman target
def create_v3_task():
payload = {
"clientKey": API_KEY,
"task": {
"type": "ReCaptchaV3TaskProxyLess",
"websiteURL": WEBSITE_URL,
"websiteKey": WEBSITE_KEY,
"pageAction": PAGE_ACTION
}
}
response = requests.post(
"https://api.capsolver.com/createTask",
json=payload
)
return response.json().get("taskId")
def get_task_result(task_id):
payload = {
"clientKey": API_KEY,
"taskId": task_id
}
while True:
response = requests.post(
"https://api.capsolver.com/getTaskResult",
json=payload
)
result = response.json()
if result.get("status") == "ready":
return result["solution"]["gRecaptchaResponse"]
elif result.get("status") == "failed":
raise Exception("Task failed: " + str(result.get("errorDescription")))
time.sleep(3)
task_id = create_v3_task()
token = get_task_result(task_id)
print("Token v3 yang diselesaikan:", token)
# Kirim `token` sebagai nilai `g-recaptcha-response` dalam formulir POST Anda
ReCaptchaV2TaskProxyLess untuk tantangan kotak centang v2 dan ReCaptchaV3TaskProxyLess untuk skoring v3 yang tidak terlihat. Menggabungkannya akan selalu menghasilkan kesalahan verifikasi reCAPTCHA gagal.ReCaptchaV2Task atau ReCaptchaV3Task (tanpa akhiran ProxyLess) dan berikan detail proxy Anda sendiri dalam payload tugas. Ini mengarahkan permintaan penyelesaian melalui IP target Anda.pageAction yang tidak sesuai menurunkan skor yang dikembalikan dan memicu hasil verifikasi reCAPTCHA gagal di sisi server. Periksa sumber halaman atau permintaan jaringan untuk menemukan string tindakan yang tepat.createTask Anda dan polling hasil secara bersamaan.Untuk otomasi berbasis browser (Puppeteer, Playwright, Selenium), ekstensi browser CapSolver dapat menangani tantangan reCAPTCHA secara otomatis tanpa mengubah logika scraping Anda.
Dapatkan Kode Bonus CapSolver Anda
Tingkatkan anggaran otomatisasi Anda secara instan!
Gunakan kode bonus CAP26 saat menambahkan dana ke akun CapSolver Anda untuk mendapatkan tambahan 5% bonus pada setiap penambahan dana — tanpa batas.
Gunakan sekarang di Dasbor CapSolver Anda
| Gejala | Kemungkinan Penyebab | Perbaikan |
|---|---|---|
| Widget tidak pernah dimuat | JavaScript diblokir atau ekstensi aktif | Aktifkan JS, nonaktifkan ekstensi |
| "Silakan coba lagi" setelah kotak centang | Konflik cache atau kuki browser | Hapus cache dan kuki, restart browser |
| Kesalahan pada submit formulir saja | Token kedaluwarsa (>120 detik) | Aktifkan ulang widget sebelum submit |
| Berjalan di satu domain, gagal di domain lain | Kunci situs tidak cocok | Tambahkan domain ke Konsol Admin reCAPTCHA |
| Gagal hanya di jaringan VPN/perusahaan | Firewall memblokir titik akhir Google | Daftarkan *.google.com, *.gstatic.com ke daftar izin |
| v3 selalu mengembalikan skor rendah | Pola perilaku otomatis terdeteksi | Gunakan API CapSolver dengan pageAction yang benar |
Kesalahan server invalid-input-secret |
Kunci rahasia salah di backend | Perbarui kunci rahasia di validasi sisi server |
Kesalahan server timeout-or-duplicate |
Token digunakan ulang atau dikirim terlalu lambat | Buat token baru per pengiriman |
| Kriteria | Perbaikan Manual | Perbaikan Berbasis API CapSolver |
|---|---|---|
| Siapa yang cocok | Pengguna akhir, pemilik situs | Pengembang, insinyur otomatisasi |
| Waktu perbaikan | 5–15 menit | Beberapa menit untuk integrasi, lalu sepenuhnya otomatis |
| Keandalan | Bergantung pada lingkungan pengguna | Konsisten — 99,99% uptime |
| Menangani kedaluwarsa token | Pengguna harus mengaktifkan ulang secara manual | Ditangani dalam kode dengan logika ulang |
| Berjalan di lingkungan tanpa tampilan | Tidak | Ya |
| Mendukung v2, v3, Enterprise | Sebagian (interaksi manual) | Dukungan lengkap di semua versi |
| Biaya | Gratis | Bayar per penggunaan dari $6 top-up |
Kesalahan verifikasi reCAPTCHA gagal memiliki penyebab yang jelas dalam hampir semua kasus. Untuk pengguna biasa, perbaikannya biasanya pengaturan browser — hapus cache, aktifkan JavaScript, atau nonaktifkan ekstensi. Untuk pengembang, penyebab akar sering kali adalah ketidakcocokan kunci, token kedaluwarsa, atau skor v3 rendah yang dipicu oleh pola perilaku otomatis.
Jika alur kerja Anda secara teratur menghadapi tantangan reCAPTCHA, menyelesaikannya secara manual tidak berkelanjutan. CapSolver menyediakan API yang andal, berbasis AI yang menyelesaikan kesalahan verifikasi reCAPTCHA secara programatis — mendukung v2, v3, dan Enterprise — sehingga otomatisasi Anda terus berjalan tanpa gangguan. Anda dapat memulai di capsolver.com dengan top-up minimal $6 dan tanpa kewajiban bulanan.
T1: Mengapa pesan verifikasi reCAPTCHA gagal muncul bahkan setelah saya menyelesaikan kotak centang?
Checkbox hanya satu sinyal. reCAPTCHA juga mengevaluasi lingkungan browser Anda, reputasi IP, dan pola interaksi. Jika salah satu dari ini terlihat mencurigakan, layanan akan mengembalikan hasil verifikasi reCAPTCHA gagal terlepas dari checkbox. Mengosongkan cache dan menonaktifkan VPN biasanya menyelesaikan ini.
Q2: Berapa lama token reCAPTCHA berlaku?
Token reCAPTCHA berlaku sekitar 120 detik sejak dibuat. Mengirim formulir setelah jendela tersebut menghasilkan kesalahan verifikasi reCAPTCHA Google di sisi server. Selalu aktifkan widget secepat mungkin sebelum pengiriman formulir.
Q3: Apakah token reCAPTCHA yang sama bisa digunakan dua kali?
Tidak. Setiap token hanya bisa digunakan sekali. Mengirim token yang sama untuk kedua kalinya mengembalikan kesalahan timeout-or-duplicate, yang dianggap sebagai respons verifikasi reCAPTCHA gagal. Buat token baru untuk setiap pengiriman.
Q4: Mengapa reCAPTCHA v3 gagal dalam skrip otomatis saya meskipun token valid?
reCAPTCHA v3 menilai perilaku, bukan hanya keabsahan token. Browser tanpa antarmuka (headless browser) tanpa gerakan mouse, riwayat scroll, dan IP datacenter akan menerima skor rendah (sering di bawah 0,5), menyebabkan situs menolak permintaan. Menggunakan API CapSolver dengan parameter pageAction yang benar mengembalikan token dengan skor yang memenuhi ambang batas standar.
Q5: Apakah penggunaan API penyelesaian CAPTCHA sesuai dengan ketentuan layanan?
Ini tergantung pada ketentuan layanan situs target dan kasus penggunaan Anda. CapSolver dirancang untuk penggunaan yang sah seperti pengujian otomatis, alat aksesibilitas, dan pengumpulan data yang tersedia secara publik. Selalu tinjau ketentuan layanan situs mana pun yang Anda akses secara programatis dan pastikan penggunaan Anda sesuai. Sebagai referensi, dokumentasi dukungan reCAPTCHA Google menjelaskan penggunaan yang dimaksudkan dari layanan tersebut, dan pedoman aksesibilitas web memberikan konteks untuk kebutuhan akses alternatif.