Ödeme Geçidi (Payment Gateway) Nedir? Online Ödemeler Açıklandı
Ödeme geçidi, bir müşterinin ödeme bilgilerini ödeme ekranında güvenle alan, bunları onay için bankalara ve kart ağlarına ileten ve “onaylandı” ya da “reddedildi” yanıtı döndüren hizmettir — genellikle birkaç saniye içinde. Uygulamanız ile finansal sistem arasındaki köprüdür. Stripe, PayPal, Adyen, Square ve Braintree iyi bilinen örneklerdir.
Bugün bu şirketlerin çoğu geçidi, para kazanmak için ihtiyacınız olan diğer her şeyle birlikte paketler; bu yüzden “ödeme geçidi”, “ödeme işlemcisi” ve “ödeme sağlayıcısı” çoğu zaman aynı şeyi ifade etmek için kullanılır.
Yapay zekâyla geliştirirken ödeme geçitleri neden önemli?
“Ödeme ekle” yapay zekâ oluşturuculara yapılan en yaygın isteklerden biridir ve yanlış yapılması en kolay olanlardan biridir. Kodun kendisi genellikle kısadır. Önemli olan etrafındaki kararlardır:
- Hangi sağlayıcı. İşinize, ülkenize ve sattığınız şeye hangisinin uyduğu.
- Kodun nerede çalıştığı. Gizli ödeme anahtarları sunucuda kalmalı, asla tarayıcıda olmamalıdır.
- Uygulamanızın bir ödemenin başarılı olduğunu nasıl öğrendiği. Güvenilir yol, müşterinin “teşekkürler” sayfasına inmesi değil, sağlayıcıdan gelen bir webhook'tur.
- Yasal ve vergi sorumluluklarınız, bunların hangisinin satıcı kaydı olduğunuza bağlıdır.
Bir geçidin ne yaptığını anlamak, net talimatlar vermenize ve sonucun güvenli olup olmadığını kontrol etmenize yardımcı olur.
Günlük bir benzetme
Dükkânda kartla ödeme yapmayı düşünün.
Tezgâhtaki kart terminali geçittir: kartınızı güvenle okur ve isteği gönderir. Karar vermez — “bu kişi 40 € ödeyebilir mi?” sorusunu bir zincir boyunca sizin bankanıza iletir ve cevabı geri alır. Dükkânın bankası (acquirer) ve sizin bankanız (issuer) kararı verir; aralarını bağlayan kart ağı (Visa, Mastercard) üzerinden.
Online bir ödeme geçidi, web için yeniden yapılmış bu terminaldir — üstüne internet üzerinden gelen kart bilgilerini güvenle işlemek için güvenlik eklenmiştir.
Online bir kart ödemesi nasıl işler?
Müşteri “Öde” tuşuna bastıktan sonraki birkaç saniyede şunlar olur:
| Adım | Ne olur | Kim yapar |
|---|---|---|
| 1. Ödeme ekranı | Müşteri kart bilgilerini güvenli bir ödeme formuna girer | Ödeme sağlayıcısının formu ya da sayfası |
| 2. Şifreleme | Bilgiler şifrelenir ve geçide gönderilir | Geçit |
| 3. Yetkilendirme isteği | İstek kart ağına ve müşterinin bankasına gider | İşlemci, kart ağı |
| 4. Kontroller | Banka bakiyeyi ve dolandırıcılık sinyallerini kontrol eder, 3D Secure gibi ek doğrulama isteyebilir | Çıkaran banka (issuer) |
| 5. Yanıt | Onaylandı ya da reddedildi bilgisi uygulamanıza döner | Geçit |
| 6. Tahsilat ve mutabakat | Para tahsil edilir ve sağlayıcının ödeme takvimine göre, ücretler düşüldükten sonra banka hesabınıza aktarılır | İşlemci, acquirer |
İki noktayı bilmek değerlidir:
- Yetkilendirme, ödenmiş olmak anlamına gelmez. Önce para ayrılır, sonra tahsil edilir, sonra hesabınıza mutabık kılınır — bu çoğu zaman günler sonra olur.
- Uygulamanız kart numarasını hiç görmemelidir. Modern sağlayıcılar, kontrol ettikleri barındırılan bir ödeme sayfası ya da gömülü alanlar sunar; uygulamanız yalnızca ödemeye ait bir referans alır.
Ana parçalar ve onları kim yönetir
| Parça | Ne demek |
|---|---|
| Ödeme geçidi | Ödeme bilgilerini güvenle alır ve iletir. |
| Ödeme işlemcisi | Bankalar arasında işlem verisini taşır. |
| Satıcı hesabı (merchant account) | Kart ödemelerini sizin adınıza alan hesap. Stripe gibi sağlayıcılar tarafından paketlenir. |
| Acquirer | Satıcı tarafındaki banka. |
| Issuer | Müşterinin bankası; onaylar ya da reddeder. |
| Kart ağı | Acquirer ve issuer'ları birbirine bağlayan Visa, Mastercard ve diğerleri. |
| Satıcı kaydı (merchant of record) | Müşteriye hukuken satış yapan ve vergi, iade ve itirazlardan sorumlu olan işletme. |
Bazı sağlayıcılar (Paddle, Lemon Squeezy) satıcı kaydı olarak hareket eder; satış vergisini ve KDV'yi sizin yerinize yönetirler, karşılığında daha yüksek ücret alırlar. Diğerleri (Stripe, PayPal) sizi satıcı kaydı olarak bırakır ve isteğe bağlı vergi araçları sunar. Seçenekler için dengeli bir bakış açısı istiyorsanız Stripe vs Paddle vs Lemon Squeezy ve Stripe vs PayPal rehberlerine bakın.
Çalışılmış bir örnek: bir kurs satmak
Online bir kursu 99 € karşılığında satıyorsunuz ve yapay zekâ oluşturucudan bir “Satın Al” düğmesi eklemesini istiyorsunuz.
- Müşteri Satın Al'a tıklar. Sunucunuz gizli anahtarını kullanarak sağlayıcıdan 99 € için bir ödeme oturumu oluşturmasını ister ve bir bağlantı alır.
- Müşteri sağlayıcının barındırılan ödeme sayfasına yönlendirilir, kartını girer ve gerekiyorsa bankasıyla 3D Secure doğrulamasını tamamlar.
- Ödeme onaylanır ve müşteri “başarılı” sayfanıza yönlendirilir.
- Ayrı olarak, sağlayıcı sunucunuza bir webhook gönderir: “X oturumu için ödeme başarılı.” Sunucunuz webhook imzasını doğrular, siparişi bulur, ödendi olarak işaretler ve kursun kilidini açar.
- Birkaç gün sonra, ücretler düşüldükten sonra para banka hesabınıza yatar.
Adım 4 en önemli olanıdır. Kursun kilidini başarılı sayfasında açsaydınız, o URL'yi bulan herkes kursu bedavaya alabilirdi; tarayıcısı erken kapanan müşteriler ise ödeyip hiçbir şey alamazdı.
Temel terimler
| Terim | Anlamı |
|---|---|
| Ödeme oturumu (checkout session) | Sunucunuzun belirli bir satın alma için oluşturduğu, tek seferlik bir ödeme sayfası ya da akışı. |
| Test modu | Test anahtarlarını ve test kart numaralarını kullandığınız bir deneme ortamı — gerçek para hareket etmez. |
| Yayımlanabilir / gizli anahtar | Yayımlanabilir anahtar tarayıcı kodunda görünebilir; gizli anahtar sunucuda kalmalıdır. |
| 3D Secure | Müşterinin ödemeyi bankasıyla onayladığı ek adım; Avrupa'da Güçlü Müşteri Kimlik Doğrulaması (SCA) kuralları kapsamında yaygındır. |
| PCI DSS | Kart verisiyle çalışan herkes için kart sektörünün güvenlik standardı. |
| İtiraz (chargeback) | Bir müşterinin ödemeye bankası üzerinden itiraz etmesi ve paranın geri alınması. |
| İade (refund) | Sizin isteğinizle geri ödenen para. |
| Ödeme aktarımı (payout) | Sağlayıcının tahsil ettiğiniz parayı banka hesabınıza aktarması. |
Yaygın yanlış anlamalar
- “Müşterileri tekrar ücretlendirmek için kart numaralarını saklamam gerekir.” Hayır. Sağlayıcılar kartı saklar ve tekrarlayan ödemeler ve abonelikler için size bir referans belirteci verir. Kart numaralarını asla kendiniz saklamamalısınız.
- “Başarılı sayfası ödemenin işe yaradığı anlamına gelir.” Ödemeleri sunucuda webhook'larla onaylayın. Yönlendirmeler atlanabilir, sahte olabilir ya da hiç gerçekleşmeyebilir.
- “Ödeme sağlayıcıların hepsi hemen hemen aynı ücrete sahip.” Ücretler sağlayıcıya, ülkeye, kart türüne ve vergi işlemlerinin dahil olup olmadığına göre değişir. Ülkeniz için her sağlayıcının güncel fiyat sayfasını kontrol edin.
- “Stripe kullanmak beni PCI uyumlu yapar.” Uyumluluğu çok daha basit hâle getirir, çünkü kart verisi sağlayıcıda kalır — ama yine de genellikle kısa bir öz değerlendirmeyi tamamlamanız gerekir.
- “Test modu ile canlı mod tamamen aynı davranır.” Oldukça yakınlar, ama canlı mod tam doğrulanmış bir hesap, canlı ortam için ayarlanmış gerçek webhook uç noktaları ve gerçek banka bilgileri gerektirir.
- “Bir ödeme geçidi vergilerimi halleder.” Yalnızca satıcı kaydıysa ya da vergi özelliklerini açıp yapılandırdıysanız. Yerel kurallarınızı kontrol edin ya da bir danışmana sorun.
Yapay zekâ oluşturucunuzdan ne istemelisiniz?
- “[Ürün] için [Stripe] Checkout ekle. Oturumu, ortam değişkeninden okunan gizli anahtarla sunucuda oluştur.”
- “Siparişleri yalnızca doğrulanmış bir webhook'tan ödendi olarak işaretle ve webhook imzasını kontrol et.”
- “Webhook'un iki kez gönderilmesini, yinelenen siparişler oluşturmadan işle.”
- “Test modu anahtarlarını kullan ve sağlayıcının test kartlarıyla, reddedilen bir kart dahil, testi adım adım anlat.”
- “Müşteri ödeme yaptıktan sonra sekmeyi kapatırsa ne olur?”
- “Bir ödeme anahtarının kullanıldığı her yeri göster ve gizli anahtarın asla tarayıcıya ulaşmadığını doğrula.”
Mythex'te ödeme geçitleri
Mythex, oluşturduğunuz uygulamalar için yerleşik bir ödeme özelliği içermez ve tek tıkla “Stripe'ı bağla” seçeneği yoktur. Seçtiğiniz sağlayıcıda bir hesap açar, test anahtarlarını proje gizli değerleri olarak eklersiniz ve ajandan ödeme akışını sunucu tarafında kurmasını istersiniz. Önizlemede sağlayıcının test kartlarıyla test edin, sonra yayımlayın. Dokümantasyon Stripe ile ödeme kabul etme adımlarını anlatır; Webhooks sayfası onay adımını kapsar.
Adım adım bir kurulum için uygulamanıza ödeme nasıl eklenir rehberine, tekrarlayan faturalandırma için ise Stripe ile abonelik nasıl eklenir rehberine bakın.
Sorular
Ödeme geçidi basitçe nedir?
Ödeme geçidi, bir müşterinin ödeme bilgilerini ödeme ekranınızdan güvenle alan, onayı için bankalara ve kart ağlarına ileten ve uygulamanıza onaylandı ya da reddedildi yanıtını döndüren bir hizmettir — genellikle birkaç saniye içinde.
Ödeme geçidi ile ödeme işlemcisi arasındaki fark nedir?
Kesin olarak geçit, ödeme bilgilerini alıp ileten güvenli ön kapıdır; işlemci ise işlemi bankalar arasında taşır. Pratikte Stripe, PayPal ve Adyen gibi modern sağlayıcılar ikisini ve satıcı hesabını tek bir hizmette birleştirir; bu yüzden terimler çoğu zaman birbirinin yerine kullanılır.
Kart kabul etmek için PCI uyumlu olmam gerekir mi?
Kart kabul eden her işletmenin bir biçimde PCI DSS güvenlik standardına uyması gerekir. Barındırılan bir ödeme sayfası ya da sağlayıcının gömülü ödeme alanlarını kullanmak, kart numaralarının sunucularınıza hiç uğramamasını sağlar ve sorumluluğunuzu büyük ölçüde azaltır. Hangi öz değerlendirmenin geçerli olduğunu sağlayıcınız söyler.
Satıcı kaydı (merchant of record) nedir?
Satıcı kaydı, müşteriye hukuken satış yapan işletmedir; satış vergisi ya da KDV'yi toplama ve ödeme, iadeler ve itirazlar gibi konulardan sorumludur. Paddle ve Lemon Squeezy gibi hizmetler sizin yerinize satıcı kaydı olarak hareket eder; Stripe ya da PayPal ile genellikle siz satıcı kaydısınızdır.
Yapay zekâyla yapılmış bir uygulamaya ödeme ekleyebilir miyim?
Evet. Bir yapay zekâ oluşturucu, uygulamanızı Stripe gibi bir sağlayıcıya bağlayan kodu yazabilir: sunucuda ödeme oturumları oluşturmak, webhook'ları işlemek ve siparişleri güncellemek. Yine de sağlayıcıda kendi hesabınız olmalıdır ve canlıya geçmeden önce her şeyi sağlayıcının test modunda denemelisiniz.