Yüksek talep gören e-commerce checkout akışları için CAPTCHA testi

Güvenli kapsam: Bu kılavuz yalnızca size ait veya yetkilendirilmiş QA, staging ve ön üretim ortamları için geçerlidir. İçerik kendi CAPTCHA entegrasyonlarınız için tanılama, test ve gözlemlenebilirlik kalıplarını ele alır — üçüncü taraf siteleri veya yetkisiz akışları kapsamaz.

QA ekipleri çoğunlukla kendi e-commerce checkout akışlarını gerçekçi yük altında doğrulamak ister. Bu kılavuz CaptchaAI ile kendi staging checkout akışınızdaki CAPTCHA entegrasyonunu nasıl test edeceğinizi gösterir — üçüncü taraf mağazalara veya gerçek ödemelere asla dokunmadan.

Güvenli kapsam

• Yalnızca size ait veya yetkilendirilmiş e-commerce QA.
• Staging'de checkout entegrasyon testleri.
• Kendi checkout formlarınızda CAPTCHA smoke testleri.
• Sahte stok, sahte ürünler, test ödeme tokenları.
• Dahili endpoint'lerde oturum sürekliliği testleri.
• Gerçek satın alma yok, üçüncü taraf mağaza yok.

Staging checkout için QA mimarisi

Üretim mimarisini mümkün olduğunca kopyalayın: checkout ön ucunu ve sipariş arka ucunu https://staging.example.com/checkout-test adresine kurun. Sahte SKU içeren ayrı bir veritabanı replikası kullanın ve ödeme ağ geçidini sandbox modunda yapılandırın.

Sahte stok ve test ödemeleri kurma

FAKE_PRODUCTS = [
    {'sku': 'QA-SKU-001', 'price_cents': 9900, 'stock': 1000},
    {'sku': 'QA-SKU-002', 'price_cents': 19900, 'stock': 500},
]

FAKE_PAYMENT_TOKEN = 'qa_pm_token_demo'
STAGING_CHECKOUT = 'https://staging.example.com/checkout-test'

Dahili testten CaptchaAI görevi gönderme

import os, time, requests

API_KEY = os.environ['CAPTCHAAI_API_KEY']
SITEKEY = os.environ['QA_TURNSTILE_SITEKEY']

def solve_turnstile():
    r = requests.post('https://ocr.captchaai.com/in.php', data={
        'key': API_KEY,
        'method': 'turnstile',
        'sitekey': SITEKEY,
        'pageurl': STAGING_CHECKOUT,
        'json': 1,
    }).json()
    task_id = r['request']
    while True:
        time.sleep(5)
        rr = requests.get('https://ocr.captchaai.com/res.php', params={
            'key': API_KEY, 'action': 'get', 'id': task_id, 'json': 1,
        }).json()
        if rr['status'] == 1:
            return rr['request']

Token'ı kendi QA endpoint'inizde doğrulama

Üretilen Turnstile token'ını dahili sipariş endpoint'inize (https://staging.example.com/qa-checkout) cf-turnstile-response alanı ile gönderin. QA endpoint'i token'ı doğrular, sahte SKU'yu onaylar ve simüle edilmiş bir sipariş kimliği döndürür.

Loglama ve QA metrikleri

Her qa_kasasi için kaydedin: çözüm süresi (saniye), backend sonuç kodu, uçtan uca gecikme ve yeniden deneme sayısı. Kendi pipeline'ınızdan medyan, P90 ve P99 ile başarı oranını toplayın — değerler staging ortamınız için gösterge niteliğindedir.

Sorun giderme

Gözlemlenebilirlik

Her QA çalıştırması için yapılandırılmış günlükler üretin. Toplam token süresi, HTTP yanıt kodu, görev kimliği ve kuyruk derinliği gibi ölçümler tablolarınızı ve uyarılarınızı besler. Ortamlarınızı (geliştirme, staging, ön üretim) ayrı kanallara yazın ve dağıtık izleme (örneğin OpenTelemetry) ile bağıntı kimliklerini eşleştirin. Tek bir kimlikten tüm senaryoyu yeniden oynatabilmek, olay sırasında tanılama süresini yarıya indirir.

Kontrol listesi

• Kapsam kesinlikle kendi uygulamalarınız veya yetkilendirilmiş kaynaklarla sınırlıdır.
• CaptchaAI anahtarı CI gizli deposunda veya kasada saklanır, kaynak kodda asla bulunmaz.
• Her çalıştırma için çağrı süresi ve yanıt kodu kayıt altına alınır.
• Geçici hatalar için idempotent yeniden deneme stratejisi kuruludur.
• Testler sürekli entegrasyon ortamınızdan tekrarlanabilir biçimde yeniden oynatılır.

Örnek QA çağrısı

Aşağıdaki Python örneği, kendi staging ortamınızdaki bir CAPTCHA widget'ını CaptchaAI üzerinden test etmek için kullanılan minimal akışı gösterir.

import os
import requests

API_KEY = os.environ['CAPTCHAAI_KEY']
QA_PAGE_URL = os.environ['QA_PAGE_URL']  # ör. https://staging.example.com/qa-login
QA_SITE_KEY = os.environ['QA_SITE_KEY']


def submit_qa_recaptcha() -> str:
    payload = {
        'clientKey': API_KEY,
        'task': {
            'type': 'NoCaptchaTaskProxyless',
            'websiteURL': QA_PAGE_URL,
            'websiteKey': QA_SITE_KEY,
        },
    }
    response = requests.post(
        'https://api.captchaai.com/createTask',
        json=payload,
        timeout=30,
    )
    response.raise_for_status()
    return response.json()['taskId']


def fetch_qa_result(task_id: str) -> dict:
    payload = {'clientKey': API_KEY, 'taskId': task_id}
    response = requests.post(
        'https://api.captchaai.com/getTaskResult',
        json=payload,
        timeout=30,
    )
    response.raise_for_status()
    return response.json()

Sık sorulan sorular

Bu akış üretim trafiğine dokunur mu?

Hayır. Tüm örnekler staging.example.com veya kendi QA alan adınız gibi yetkilendirilmiş ortamları varsayar. Üretim CAPTCHA korumasını kendi staging kopyanızda yeniden üretin.

API anahtarımı kodda saklayabilir miyim?

Hayır. Anahtarı CI gizli yöneticisi, ortam değişkeni veya kasa hizmeti üzerinden enjekte edin. Kod tabanına işlenen anahtarlar derhal döndürülmelidir.

Geçici hatalar için ne öneriyorsunuz?

İdempotent yeniden deneme: üstel geri çekilme (örneğin 1s, 2s, 4s) ve üst sınır ile birlikte. Ağ hataları, 5xx yanıtları ve ERROR_NO_SLOT_AVAILABLE için yeniden deneme uygundur; kalıcı kimlik doğrulama hataları için değildir.

Güvenli ilgili kılavuzlar

• CaptchaAI hızlı başlangıç
• Yetkili CAPTCHA QA testleri
• Kendi formlarınızda CAPTCHA endpoint testleri
• Tarayıcı testi başarısız ama API başarılı: hata ayıklama
• reCAPTCHA v2 API ile çözme
• Cloudflare Turnstile API ile çözme
• GeeTest v3 API ile çözme

CAPTCHA entegrasyonunuzu kendi ortamınızda CaptchaAI ile doğrulayın.