DerslerWeb sitenizde ödeme nasıl alınır

Mini ders 26 / 30 · Sitenizi çalıştırın ve bakımını yapın

Test ortamında ödeme hedefi seçin

Bu ders kimler için?

Web sitesinde ödeme düğmesi isteyenler için. Temel yol, barındırılan ödeme sayfası ve bağlantı için kodlama asistanı kullanır; sunucu kodu, veritabanı kurulumu ve webhook programlama isteğe bağlı ileri çalışmadır.

Kart bilgilerini kendiniz toplamak yerine barındırılan ödeme sayfasıyla başlayın.

Bu derste ne öğreneceksiniz?

  • Test ortamı olduğu açıkça belli olan ödeme bağlantısı oluşturun.
  • Web sitesinin ödeme düğmesini bağlayıp sınayın.
  • Dönüş sayfasına güvenmek yerine sağlayıcıda gerçek ödendi/iptal durumlarını doğrulayın.
Açıklama, çözülmüş örnek ve alıştırma

Başlamadan önce

Test ortamı olan, size ait uygun Stripe hesabı ve verilen sayfa. Kodlama asistanı herkese açık test bağlantısını yapılandırabilir. Temel yol Supabase, tarayıcıda gizli API anahtarı veya özel sunucu gerektirmez.

Başlamak için gereken beceriler

Bu dersleri bitirmiş olmanız şart değil; gereken beceriler sizde zaten varsa buradan başlayabilirsiniz. Hazır değilseniz bağlantılardaki hazırlık derslerini açın. Başlangıç dosyaları verildiği için önceden kişisel bir siteniz olması gerekmiyor.

  1. Web sitenizi GitHub üzerinden nasıl yayımlarsınız?

    Bir alıştırma deposunu barındırma hizmetine bağlayın.

Tahmini süre: 35–53 dk

Hazır örnek dosyalarla, gerekli hesap ve araçlar kurulmuşken çalışma tahmini. Kurulum, yayınlanma sırası ve e-posta/DNS beklemeleri ayrıca zaman alabilir. Hesap uygunluğu, etkinleştirme ve gerçek bir işletmeyi satışa açma bu test çalışmasının kapsamı dışındadır. Gerçek para veya gerçek kart bilgisi kullanılmaz.

Konuyu anlayalım

Kendi Stripe test ortamınızı ve kurgusal ürün/fiyat kullanın. Verilen sayfayı asistanınızla açıp ödeme düğmesinin neyi anlatacağına karar verin.

Alıştırmayı test modunda tutun. Ziyaretçinin başarı adresini açması herhangi bir ödeme yapıldığını kanıtlamaz.

Somut bir örnek

Örneğin ürün, bir kerelik USD 5 test fiyatıyla “Sample digital workshop” olabilir. Düğme test ödemesini açtığını söylemeli; ne sayfa ne de bu ders ürünün otomatik teslimini vaat eder.

Verilen herkese açık sayfayı temel barındırılan Payment Link alıştırması için kullan. Kendi Stripe test ortamımda bir test ürünü/fiyatı oluşturmama yardım et; yalnızca herkese açık test ödeme URL'sini sayfa yapılandırmasına koy. İsteğe bağlı veritabanı/webhook yolunu kurma veya canlı kimlik bilgilerini kullanma. Yalnızca hedeflenen alıştırma sayfasını yayımlamama ve sağlayıcının Dashboard bölümünde test ödemesini doğrulamama yardım et. Dönüş sayfası ödeme kanıtı değildir.

Bu adımda kullanılan dosyalar

Buradan başlayınUygulama dosyaları

Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

Dosyaları tek tek inceleyin (isteğe bağlı)

Sıra sizde

Düğmeniz hangi test ürününü ve fiyatını anlatacak; ödemeyi nerede doğrulayacaksınız?

Çözülmüş örneği göster

Örnek ürünüm, Stripe test ortamında USD 5 fiyatlı “Sample digital workshop”. Düğme onun barındırılmış test ödemesini açıyor. Eşleşen ödemenin paid durumunu, tutarını ve para birimini Stripe hesabımda doğrulardım; success.html ziyareti ödemeyi kanıtlamazdı.

İyi bir cevap neleri içermeli?

  • Hayali test ürününü, tutarı ve para birimini belirtir.
  • Ödemeyi doğrulamak için sağlayıcının ödeme kaydını gösterir.
Nasıl çalışır? (isteğe bağlı)

Sağlayıcının ödeme sayfasıyla test ödemesi alın

Sağlayıcının barındırdığı bir test sayfasıyla başlayın ve neyi başarılı ödeme sayacağınızı açıkça belirleyin.

Sağlayıcının barındırdığı Payment Link, kendi sayfanıza kart giriş alanları koymadan ödeme bilgilerinin sağlayıcı tarafından toplanmasını sağlar. Bu çalışma yalnızca Stripe’ın sandbox/test ortamını ve test kartı değerlerini kullanır.

Site ödeme sayfasını açar; sunucu ise imzalı ödeme olaylarını alıp bir makbuz kaydeder. Dönüş sayfası yalnızca yönlendirme içindir: bir URL’yi herkes açabilir, dolayısıyla o sayfanın açılması ödeme yapıldığını kanıtlamaz.

Çözülmüş örnek

success.html doğrudan açıldığında hiçbir makbuz oluşmamalıdır. Yapılandırılmış test Payment Link bağlantısından gelen, ödemesi doğrulanmış bir oturum ise müşteri sitenize hiç dönmese bile makbuz oluşturabilir.

Stripe: Payment Link ile ödemeden sonra · Stripe: test etme

Ek teknik alıştırma

Bir kullanıcı /success.html?paid=true adresini ziyaret ediyor. Sisteminiz ücretli ürüne erişim vermeli mi?

Çözülmüş örneği göster

Hayır. Sorgu parametresi ziyaretçinin kontrolündedir. Amaçlanan işleme bağlı, doğrulanmış bir sağlayıcı olayı veya sunucudan yapılan bir sağlayıcı kontrolü kullanın.

  • Çağrıyı yapanın kontrol ettiği URL’leri ödeme kanıtı olarak kabul etmez.
  • Sağlayıcıda doğrulanmış bir ödeme durumu arar.

Adım 1 · Web sitenizde ödeme nasıl alınır

Test bağlantısını oluşturup bağlayın

Sağlayıcı kontrol panelini kullanın; sayfayı asistan düzenlesin.

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

Kendi hesabınızda tek seferlik test ürünü/fiyatı ve Payment Link oluşturun. Herkese açık ödeme sayfasını oturum kapalıyken açın; ardından verilen herkese açık sayfaya bağlaması için test URL'sini asistana verin.

İlerlemeden önce ürünü, tutarı, para birimini ve test ortamını kontrol edin. Sayfada yalnızca herkese açık test ödeme URL'si bulunmalıdır; temel bağlantı için özel imzalama veya API anahtarı gerekmez.

Somut bir örnek

Başarılı kurulum ürünün herkese açık test ödeme sayfasını oturum kapalı açar. Stripe hesap ayarları veya değiştirilmemiş test_REPLACE örneği kullanılabilir ödeme bağlantısı değildir.

Bu adımda kullanılan dosyalar

Buradan başlayınUygulama dosyaları

Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

Dosyaları tek tek inceleyin (isteğe bağlı)

Sıra sizde

Web sitesi düğmesi doğru ürün ve fiyatla hedeflenen test ödeme sayfasını açıyor mu?

Çözülmüş örneği göster

Örnek kontrol: Web sitesi bağlantısı, Stripe hesap girişimi gerektirmeden “Sample digital workshop” için USD 5 herkese açık test ödeme sayfasını açıyor. Sayfada yalnızca o herkese açık test bağlantısı ayarlı; bu temel yol API anahtarı veya webhook sırrı gerektirmiyor.

İyi bir cevap neleri içermeli?

  • Oturum kapalı barındırılmış ödemeyi amaçlanan ürün, tutar, para birimi ve test moduyla karşılaştırır.
  • Sağlanan sayfa ayarında yalnızca herkese açık test Payment Link kullanır.
Nasıl çalışır? (isteğe bağlı)

Ayrı test ödeme sayfasını yapılandırın

Herkese açık ödeme URL’lerini sunucu kimlik bilgilerinden ve webhook sırlarından ayrı tutun.

Tek seferlik bir test Payment Link bağlantısı, veritabanı tablosu ve webhook hedefi oluşturmak için START-HERE.txt dosyasını izleyin. Bu deneme projesine sürümü sabitlenmiş Stripe bağımlılığını kurun ve oluşan kilit dosyasını koruyun.

config.js içine yalnızca herkese açık test ödeme URL’sini koyun. Sunucu ortamındaki değerler test gizli anahtarını, uç noktanın imzalama sırrını, beklenen Payment Link kimliğini ve özel veritabanı anahtarını içerir. Bu kod, canlı ortam kimlik bilgilerini özellikle reddeder.

Yerel çalışma sırasının tamamı için run-locally.txt dosyasını açın: kökteki özel ortamı hazırlayın, yalnızca deneme projesini bağlayın ve Netlify işlevlerine istek ileten yerel aracı başlatın. server-env.example.txt gerçek sırlar olmadan değişken adlarını listeler. Yalnızca HTML’yi açmak sunucuyu çalıştırmaz.

Çözülmüş örnek

Webhook imzalama sırrı, hangi uç noktanın olaylarını kabul ettiğinizi doğrular. Herkese açık Payment Link bağlantısı veya API anahtarı değildir; yanlış sırrı kopyalamak imza doğrulamasını başarısız kılar.

Node.js: desteklenen sürümlerin durumu

Ek teknik alıştırma

public/config.js içine hangisi konur: test ödeme URL’si mi, whsec imzalama sırrı mı?

Çözülmüş örneği göster

Oraya yalnızca herkese açık ödeme URL’si konur. Webhook sırrını ve sağlayıcı/veritabanı gizli anahtarlarını sunucu ortam değişkenlerinde tutun.

  • İmzalama ve API sırlarını sunucuda tutar.
  • Tarayıcı kodunda yalnızca herkese açık ödeme hedefini kullanır.

Adım 2 · Web sitenizde ödeme nasıl alınır

Sağlayıcıda bir test ödemesini tamamlayın

Resmî test talimatlarını kullanıp hesap sonucunu inceleyin.

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

Stripe'ın bağlantılı test kılavuzunu yalnızca test ortamında izleyin. Geçici test ödemesini tamamlayın; ardından hesabınızda gerçek ödeme/oturum kaydını bulun.

Beklenen tutarı, para birimini ve ödendi durumunu orada doğrulayın. Tamamlanan sayfa akışı, özellikle sonradan kesinleşen yöntemlerde ödemenin son durumundan farklı olabilir.

Somut bir örnek

“Ödeme sayfası tamamlandı” ve “ödemenin yapıldığı doğrulandı” her zaman aynı gözlem değildir.

Bu adımda kullanılan dosyalar

Buradan başlayınUygulama dosyaları

Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

    Dosyaları tek tek inceleyin (isteğe bağlı)

    Sıra sizde

    Sağlayıcı kaydı test ödemeniz için gerçekte ne bildirdi?

    Çözülmüş örneği göster

    Örnek sağlayıcı sonucu: Eşleşen test ödemesi USD 5 için paid olarak işaretli; seçilen test fiyatıyla uyuşuyor. Sağlayıcı processing veya unpaid bildiriyorsa ödeme sayfası bitti diye ödendi demek yerine o durumu kaydederdim.

    İyi bir cevap neleri içermeli?

    • Eşleşen test ödemesini ve gerçek paid durumunu sağlayıcı hesabında bulur.
    • Kayıtlı tutarı ve para birimini seçilen test fiyatıyla karşılaştırır.
    Nasıl çalışır? (isteğe bağlı)

    Olayı doğrulayın ve ödenmiş durumu bir kez kaydedin

    JSON içeriğini yorumlamadan önce ham verinin doğruluğunu sınayın.

    İstek işleyicisi, değiştirilmemiş ham istek baytlarını ve Stripe-Signature değerini resmi SDK’ya verir. İmza doğrulanmadan JSON’u ayrıştırmak veya yeniden biçimlendirmek bu baytları değiştirebilir ve doğrulamayı bozabilir.

    Yalnızca beklenen olay türlerini, test modunu, eşleşen payment_link değerini ve payment_status=paid durumunu kabul eder. Gecikmeli ödeme yöntemlerinde ödeme başarılı olmadan ödeme adımları tamamlanabilir; bu nedenle yalnızca checkout işleminin tamamlanması yeterli değildir. Benzersiz session_id, tekrar gelen kayıt ekleme denemelerinin ikinci bir makbuz oluşturmasını önler.

    İki ayrı olay kimliği aynı ödeme oturumunu anlatabilir: örneğin önce ödeme adımlarının tamamlanması, ardından asenkron ödemenin başarılı olması. session_id birincil anahtarı, on_conflict=session_id ve resolution=ignore-duplicates ile birlikte kalıcı makbuz ekleme işleminin güvenle tekrarlanmasını sağlar. Başarısız bir veritabanı yazımı gizlenmez: olayın yeniden denenebilmesi için 503 döner.

    Çözülmüş örnek

    Aynı ödenmiş oturum iki kez iletildiğinde de tek bir birincil anahtar değeri vardır. Veritabanı hatasında, sonucu kaybolan bir olayı alınmış saymak yerine teslimat yeniden denensin diye 503 döner.

    Stripe: webhook imzasını doğrulama ve yeniden denemeler

    Ek teknik alıştırma

    payment_status=unpaid olan checkout.session.completed olayı neden henüz ödenmiş sipariş sayılamaz?

    Çözülmüş örneği göster

    Bazı ödeme yöntemleri daha sonra onaylanır. Ödenmiş makbuz kaydetmeden önce, gereken durumlarda asenkron başarı olayı da dahil olmak üzere doğrulanmış ödenmiş durumu bekleyin.

    • Ödeme adımlarının tamamlanmasıyla ödemenin kesinleşmesini ayırır.
    • Uygun ödenmiş durum onayını bekler.

    Adım 3 · Web sitenizde ödeme nasıl alınır

    İptali ve doğrudan dönüş sayfasını deneyin

    Ziyaretçinin gezinmeyle ödendi sonucu üretemediğini kontrol edin.

    Açıklama, çözülmüş örnek ve alıştırma

    Konuyu anlayalım

    Ayrı test ödeme sayfası başlatıp ödemeden ayrılın veya barındırılmış sayfanın gerçekten sunduğu iptal yolunu kullanın. Sağlanan success.html sayfasını ayrıca doğrudan açın. İkisini sağlayıcının test ödeme kayıtlarıyla karşılaştırın.

    Terk edilen ödeme, tam “canceled” etiketi yerine tamamlanmamış veya açık kalabilir. İki işlem de yeni, ödenmiş alışveriş diye bildirilmemeli. Temel sayfa ürünü otomatik teslim etmez.

    Somut bir örnek

    success.html açmak veya adresine paid=true eklemek, Stripe’ta eşleşen ödenmiş ödeme oluşturmaz. Siteye dönmek ve ödemeyi kanıtlamak ayrı işlemlerdir.

    Bu adımda kullanılan dosyalar

    Buradan başlayınUygulama dosyaları

    Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

      Dosyaları tek tek inceleyin (isteğe bağlı)

      Sıra sizde

      İptal ve doğrudan dönüş sayfası ziyareti neyi kanıtladı, neyi kanıtlamadı?

      Çözülmüş örneği göster

      Bu örnek kontrolde ikinci ödeme tamamlanmadan bırakıldı; yeni ödenmiş kayıt yoktu. success.html doğrudan açılınca yalnızca dönüş mesajı göründü. İki işlem de satın almayı kanıtlamaz; temel sayfa otomatik ürün erişimi vermez.

      İyi bir cevap neleri içermeli?

      • İptal edilmiş veya tamamlanmamış ödeme sayfasını eşleşen ödenmiş ödemeden ayırır.
      • Dönüş sayfasına doğrudan erişimin ödemeyi kanıtlamadığını veya teslim sağlamadığını anlar.
      Nasıl çalışır? (isteğe bağlı)

      Bir test ödemesini baştan sona izleyin

      Ödeme oturumunu, imzalı olayı ve kaydedilmiş makbuzu eşleştirin.

      Sandbox ödeme sayfanızda yalnızca resmi test kartı değerlerini kullanın. Hesabınızda oluşan oturumu ve webhook teslimatını bulun, ardından deneme projesindeki özel payment_receipts tablosunu inceleyin.

      Tutarı ve para birimini bu oturumla karşılaştırın. Aynı gerçek test olayını yeniden gönderin ve hâlâ tek satır olduğunu doğrulayın. İmzasız bir istek ve başarı sayfasına doğrudan ziyaret deneyin; ikisi de ödeme kaydı oluşturmamalıdır.

      Çözülmüş örnek

      Webhook’un 200 yanıtı vermesi, işleyicinin bir şeyi aldığını kabul ettiğini gösterir. Bütün olayların amaçlanan ürüne ait olduğunu varsaymak yerine eşleşen makbuzu ve oturumu kontrol edin.

      Ek teknik alıştırma

      Webhook ilgisiz bir olay için 200 döndürüyor. Bu, bir makbuz olması gerektiği anlamına gelir mi?

      Çözülmüş örneği göster

      Hayır. İşleyici, işleme almadığı olayları makbuz oluşturmadan aldığını bildirir. Amaçlanan kaydı yalnızca eşleşen, ödenmiş bir test oturumu oluşturmalıdır.

      • Bilerek işleme alınmayan olayları anlar.
      • Saklanan durumu belirli ödenmiş oturumla eşleştirir.

      Adım 4 · Web sitenizde ödeme nasıl alınır

      Temel ödeme yolunu teslim edin

      Tam ticaret sistemi iddia etmeden faydalı bağlantıyı tamamlayın.

      Açıklama, çözülmüş örnek ve alıştırma

      Konuyu anlayalım

      Düzeltmeden sonra web sitesi düğmesini ve test ortamı ödeme kontrollerini tekrarlayın. Alıştırma sayfasını/bağlantısını ve başarılı, iptal edilmiş veya tamamlanmamış denemelerin hassas bilgileri çıkarılmış kaydını saklayın.

      Gerçek satıştan önce uygun işletmenizi/hesabınızı, fiyatı/para birimini, koşulları ve operasyon sürecini doğrulayın. Otomatik erişim, imzalı olaylar ve veritabanı kurtarma aşağıdaki isteğe bağlı ileri materyale aittir.

      Somut bir örnek

      Çalışan barındırılan ödeme düğmesi geçerli küçük bir sonuçtur; yapılmamış teslim arka ucunun var olduğuna kanıt değildir.

      Bu adımda kullanılan dosyalar

      Buradan başlayınUygulama dosyaları

      Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

      Dosyaları tek tek inceleyin (isteğe bağlı)

      Sıra sizde

      Test yolunu, gerçek test ortamı sonuçlarını ve gerçek açılıştan önce gerekenleri sunun.

      Hazırlanacak çıktı: Test ödeme bağlantınız/sayfanız ve gerçek test ortamı ödeme/iptal gözlemleri; gerçek ücret çekimi yok.

      Çözülmüş örneği göster

      Örnek teslim kaydı: Sayfa USD 5 atölye test ödemesini açıyor; eşleşen bir test ödemesi USD 5 için paid; terk edilen deneme ödenmemiş; dönüş sayfasını doğrudan açmak iki kaydı da değiştirmiyor. Gerçek ücret veya otomatik ürün teslimi denenmedi. Gerçek yayından önce uygun hesap, gerçek koşullar ve doğrulanmış teslim süreci hâlâ gerekli.

      İyi bir cevap neleri içermeli?

      • Ayarlı herkese açık test yolunu ödeme ve tamamlanmamış/iptal edilmiş sonuçlarıyla sunar.
      • Gerçek ücretlendirme ve otomatik teslimin, tamamlanan temel testin dışında olduğunu söyler.
      Nasıl çalışır? (isteğe bağlı)

      Ödeviniz: gerçek ücret almadan kurtarmayı prova edin

      Ödeme akışı, veritabanına yazılamayan bir kaydı sonradan tamamlayabilmelidir.

      Gözden çıkarılabilir projede geçici olarak hatalı bir veritabanı ayarı kullanın ve gerçek ödenmiş test olayınızı yeniden gönderin. Başarı dışı yanıtı ve yeni makbuz oluşmadığını gözlemleyin. Yapılandırmayı düzeltip yeniden gönderin; sonra tam olarak bir eşleşen satır bulunduğunu doğrulayın.

      Gerçek satıştan önce nelerin tamamlanması gerektiğini açıklayın: desteklenen hesap/işletme kurulumu, doğru fiyat/para birimi ve koşullar, kalıcı teslimat işlemleri, hesap mutabakatı, iadeler ve işleyişin izlenmesi. Bu atölye yalnızca test makbuzlarını kaydeder.

      Çözülmüş örnek

      Depolama başarısız olduğu halde uç nokta “başarılı” derse, kaydınız oluşmadan otomatik yeniden denemeler durabilir. Hatanın doğru bildirilmesi, güvenilir ödeme işlemenin bir parçasıdır.

      Çözümün bütün adımlarını reference/assignment-walkthrough.txt dosyasında bulabilirsiniz. Adımları kendi sonucunuzla karşılaştırın; kontrol kaydını kendi projenizde gözlemlediklerinizle doldurun.

      Ek teknik alıştırma

      Başarısız bir kayıt denemesini ve tekrarlanan isteklerde ikinci makbuz oluşturmayan başarılı kurtarmayı gösterin.

      Çözülmüş örneği göster

      Ayrı deneme projesinde npm install ile bağımlılıkları kurun; oluşan package-lock.json dosyasını o projeyle birlikte koruyun. Yalnızca test Payment Link bağlantısı ve sk_test_ kimlik bilgileri kullanın. Herkese açık bağlantı, webhook imzalama sırrı değildir.

      Eşleşen ödenmiş test oturumunuzu, imzalı webhook teslimatını ve aynı session_id, tutar ve para birimini taşıyan özel makbuzu bulun. O olayı yeniden iletin: birincil anahtar ve ignore-duplicates tercihi sonucunda tek makbuz kalmalıdır. İmzasız istek veya başarı sayfasına doğrudan ziyaret hiçbir makbuz oluşturmamalıdır.

      Hata provasında SUPABASE_URL değerini yalnızca gözden çıkarılabilir yerel/sunucu ortamında geçici olarak geçersiz bir test hedefine değiştirin. Aynı gerçek test olayını yeniden iletin ve yeniden denenebilir hatayı gözlemleyin. Ayarı düzeltin, tekrar iletin ve tek bir kalıcı makbuzu doğrulayın. Üretim ayarlarını asla değiştirmeyin veya gerçek kartla test yapmayın.

      • Kalıcı kayıt başarısızken işlemenin başarılı olduğu bildirilmez.
      • Kurtarma tek bir makbuz oluşturur; gerçek ödeme bilgisi veya para kullanılmaz.

      Ders işine yaradı mı?

      Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.