Captcha Doğrulaması

Otomatik botlar ve dolandırıcılar, çalıntı kredi kartı numaralarını e-ticaret ödeme formlarında art arda denerler (card-testing saldırıları). Ödeme işleminden önce bir captcha doğrulaması yapmak, bu saldırılara karşı en hesaplı ve etkili savunmadır.

captcha eklentisi, ödeme sağlayıcısını çağırmadan önce token'ı Cloudflare Turnstile, Google reCAPTCHA v3 veya hCaptcha servisleriyle doğrular.

KurulumCopy Anchor Link

import { betterPayment, iyzico } from 'better-payment';
import { captcha } from 'better-payment/plugins';

const payment = betterPayment({
  providers: { iyzico: iyzico({ /* ... */ }) },
  plugins: [
    captcha({
      provider: 'cloudflare-turnstile',
      secretKey: process.env.TURNSTILE_SECRET!,
    }),
  ],
});

Nasıl Çalışır?Copy Anchor Link

1. Token Çıkarma: Eklenti istek gövdesini (captchaToken, cf-turnstile-response, g-recaptcha-response, h-captcha-response) ve HTTP başlıklarını (x-captcha-response) otomatik inceler.
2. Sunucu Tarafı Doğrulama: Ödeme işlemi başlamadan hemen önce token, seçilen servisin siteverify API'si ile sunucu tarafında doğrulanır.
3. Bot Engelleme: Token eksikse veya geçersizse istek doğrudan status: 'failure' ve standart CAPTCHA_MISSING ya da CAPTCHA_INVALID hata koduyla reddedilir.
4. Banka Callback'lerini Etkilemez: Banka yönlendirmeleri, 3D Secure onayları ve webhook bildirimleri captcha eklentisinden muaf tutulur.

Desteklenen SağlayıcılarCopy Anchor Link

Cloudflare TurnstileCopy Anchor Link

Kullanıcı dostu ve gizlilik odaklı modern doğrulama:

captcha({
  provider: 'cloudflare-turnstile',
  secretKey: process.env.TURNSTILE_SECRET_KEY!,
});

Google reCAPTCHA v3Copy Anchor Link

Davranışsal puan eşiği (0.0 ile 1.0 arası) desteği:

captcha({
  provider: 'google-recaptcha',
  secretKey: process.env.RECAPTCHA_SECRET_KEY!,
  minScore: 0.5, // reject submissions with score < 0.5
});

hCaptchaCopy Anchor Link

captcha({
  provider: 'hcaptcha',
  secretKey: process.env.HCAPTCHA_SECRET_KEY!,
});

İstemci (Frontend) ÖrneğiCopy Anchor Link

Ödeme isteğinizde token'ı iletin:

// Next.js / React with Cloudflare Turnstile
const res = await fetch('/api/pay/iyzico/payment', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-captcha-response': turnstileToken,
  },
  body: JSON.stringify({
    price: '150.00',
    paidPrice: '150.00',
    card: { ... },
  }),
});

SeçeneklerCopy Anchor Link