Next.js mağazasında 3D Secure ödeme akışı nasıl kurulur

3D Secure nedir ve akış nasıl işler

3D Secure, kartı çıkaran bankanın kart sahibini ayrıca doğruladığı bir adımdır. Müşteri çoğunlukla SMS kodu ya da banka uygulaması onayıyla doğrulama yapar. Birçok ödeme sağlayıcı ve banka çevrimiçi kart ödemelerinde bu adımı zorunlu tutar, bu yüzden bir e-ticaret sitesinde ödeme akışı bu adımı hesaba katarak tasarlanmalıdır.

Akışın özelliği, müşterinin bir noktada senin sitenden çıkıp bankanın sayfasına gitmesi ve oradan geri dönmesidir. Bu yüzden ödeme sonucunu tarayıcıdan değil, sunucudan öğrenmen gerekir.

Adım adım akış

1. Müşteri ödeme formunu gönderir. Kart bilgisi sunucuna uğramadan sağlayıcının kendi alanına ya da API'sine gider.
2. Sunucun ödemeyi sağlayıcıda başlatır ve sipariş numarasını kendi veritabanında bekliyor olarak kaydeder.
3. Sağlayıcı bir yönlendirme adresi ya da otomatik gönderilen bir HTML formu döndürür.
4. Ön yüz müşteriyi bu adrese tam sayfa yönlendirir ve banka doğrulama sayfası açılır.
5. Müşteri doğrulamayı tamamlar, banka sağlayıcıya, sağlayıcı da senin geri dönüş adresine döner.
6. Geri dönüş adresin, ödemenin durumunu sağlayıcıdan sunucu tarafında sorgular ve siparişi günceller.
7. Müşteri sipariş sonuç sayfasına yönlendirilir.

Next.js tarafında yapılacaklar

Başlatma ve geri dönüş adımlarını Route Handler olarak yaz. Geri dönüş adresi bankadan POST ile çağrılabilir; bu durumda sonucu 303 ile bir sonuç sayfasına yönlendir ki tarayıcı sayfayı yenilediğinde ödeme tekrar işlenmesin. Aşağıdaki örnek sağlayıcıdan bağımsız bir iskelet gösterir.

// app/api/payments/callback/route.ts
export async function POST(request: Request) {
  const form = await request.formData();
  const orderId = String(form.get("orderId") ?? "");

  // Gelen sonuca güvenme. Gerçek durumu sağlayıcıdan sor.
  const payment = await provider.getPayment(orderId);
  if (payment.status === "paid") {
    await markOrderPaid(orderId, payment.id);
  }

  return Response.redirect(new URL(`/orders/${orderId}`, request.url), 303);
}

Sık yapılan hatalar

• Adres çubuğundaki ya da form gövdesindeki sonuca güvenip siparişi ödenmiş saymak.
• Müşterinin doğrulamayı yarıda bırakmasını düşünmemek. Bekleyen siparişler için bir zaman aşımı ve yeniden deneme yolu olmalı.
• Doğrulama sayfasını iframe içinde açmak. Birçok banka sayfası buna izin vermez, tam sayfa yönlendirme daha uyumludur.
• Aynı ödeme için geri dönüş adresinin iki kez çalışması. Siparişi durumuna göre güncelle ve işlemi tekrarlanabilir yaz.
• Kart numarasını ya da CVV'yi kendi sunucunda ya da loglarında tutmak.