
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.
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.
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
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.
Sık yapılan hata
Başarı sayfası açıldığı için satın alınan ürüne erişim vermek.
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
Sıra sizde
Web sitesi düğmesi doğru ürün ve fiyatla hedeflenen test ödeme sayfasını açıyor mu?
Cevabını ders asistanıyla değerlendir
Çö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.
- 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.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
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.
Sık yapılan hata
Yerel yönlendirme uç noktasının sırrını, barındırılan uç noktanın sırrıyla karıştırmak.
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.
Sıra sizde
Sağlayıcı kaydı test ödemeniz için gerçekte ne bildirdi?
Cevabını ders asistanıyla değerlendir
Çö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.
- 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.
Bu adımda kullanılan 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.
Sık yapılan hata
payment_status değerine bakmadan tamamlanan her ödeme oturumunu ödenmiş saymak.
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.
Sıra sizde
İptal ve doğrudan dönüş sayfası ziyareti neyi kanıtladı, neyi kanıtlamadı?
Cevabını ders asistanıyla değerlendir
Çö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.
- İ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.
Bu adımda kullanılan 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.
Sık yapılan hata
Alındığı bildirilen her webhook’un yeni bir sipariş anlamına geldiğini sanmak.
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.
Sıra sizde
Başlangıç malzemeleri
Başlangıç dosyaları ve deneme içerikleri hazır. Gerçek servis doğrulaması için Başlamadan önce bölümünde belirtilen kendi hesabınız, gelen kutunuz veya alan adınız gerekir. Bunlar olmadan dosyaları inceleyebilirsiniz; gerçekten denemediğiniz canlı adımı denenmedi diye kaydedin.
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.
Cevabını ders asistanıyla değerlendir
Çö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.
- 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.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
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.
Sık yapılan hata
Makbuz kaydeden bir örneği, üretimde kullanılabilecek eksiksiz bir ticaret sistemi diye sunmak.
Ders işine yaradı mı?
Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.
Öğrenmeye devam edin
- İlk kişisel web sitenizi nasıl kurarsınız?
- Web sitenizi GitHub üzerinden nasıl yayımlarsınız?
- Kendi alan adınızı web sitenize nasıl bağlarsınız?
- Kendi alan adınızla e-posta nasıl kurulur
- Web sitenizi telefonda rahat kullanılır hale nasıl getirirsiniz?
- Web sitenizdeki görsellerin daha hızlı yüklenmesini nasıl sağlarsınız?
- Sitenize gelen geri bildirimler gelen kutunuza nasıl ulaşır
- Sitenize e-posta aboneliği nasıl eklenir
- Web sitenizden otomatik e-posta nasıl gönderirsiniz?
- Formdan gelen bilgileri veritabanına nasıl kaydedersiniz?
- İnsanların web sitenizde oturum açmasını nasıl sağlarsınız?
- Bir sayfayı nasıl yalnızca izin verilen kişilere açarsınız?
- Kullanıcıların profil bilgilerini düzenlemesini nasıl sağlarsınız?
- Kullanıcıların görsel yüklemesini nasıl sağlarsınız?
- API anahtarlarını tarayıcıya göndermeden nasıl kullanırsınız?
- Başka bir API’den gelen veriyi web sitenizde nasıl gösterirsiniz?
- Web sitenize yapay zekâ sohbeti nasıl eklersiniz?
- Sohbetin kendi içeriğinize dayanarak yanıt vermesini nasıl sağlarsınız?
- Web sitenize nasıl blog eklersiniz?
- Web sitenize nasıl arama eklersiniz?
- Web sitenize nasıl başka bir dil eklersiniz?
- Google’ın sitenizi bulmasına nasıl yardımcı olursunuz
- Bağlantı paylaşırken sitenizin önizlemesi nasıl düzeltilir
- Sitenizde ziyaretler ve yararlı işlemler nasıl ölçülür
- Ziyaretçilerin randevu almasını nasıl sağlarsınız?
- Yayımlamadan önce site değişiklikleri nasıl önizlenir
- Hatalı yayımlanan web sitenizi önceki çalışan sürüme nasıl döndürürsünüz?
- Web sitenizin verilerini nasıl yedekler ve geri yüklersiniz?
- Canlı sitenizdeki hatalar nasıl bulunur ve düzeltilir