Mini ders · Türkçe

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

Ödeme arka ucu oluşturmadan test Payment Link oluşturun, verilen sayfaya bağlayın ve sağlayıcı hesabınızda ödemeyi doğrulayın.

Etkileşimli derse başlaDers notlarını oku

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.

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.

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.

Neler öğreneceksin?

  • 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.

Uygulama dosyaları

Adım 1

Test ortamında ödeme hedefi seçin

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

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.

Stripe: Payment Link oluşturun · Stripe: test etme

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

Inspect individual files (optional)
How it works (optional)

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

Extra implementation exercise

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 2

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

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

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.

Stripe: Payment Link oluşturun

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

Inspect individual files (optional)
How it works (optional)

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

Extra implementation exercise

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 3

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

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

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.

Stripe: test etme

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

    Inspect individual files (optional)
    How it works (optional)

    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

    Extra implementation exercise

    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 4

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

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

    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

    Start hereUygulama dosyaları

    Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

      Inspect individual files (optional)
      How it works (optional)

      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.

      Extra implementation exercise

      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 5

      Temel ödeme yolunu teslim edin

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

      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

      Start hereUygulama dosyaları

      Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

      Inspect individual files (optional)
      How it works (optional)

      Ö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.

      Extra implementation exercise

      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.

      Öğrenmeye devam edin

      Diğer dersleri inceleyin