Ödeme orkestrasyonu, faturalama sisteminizle birden fazla ödeme sağlayıcısı arasında duran ve her müşteri, her ödeme için hangi sağlayıcının kullanılacağına, başarısız ödemelerin nasıl tekrar deneneceğine ve sonuçların tek bir yerde nasıl kaydedileceğine karar veren katmandır. SaaS şirketi için anlamı şu: her sağlayıcıya ayrı bir faturalama akışı yazmadan birden fazla sağlayıcı üzerinden satış yapabilirsiniz.
Bu yazıda SaaS şirketlerinin neden ikinci bir sağlayıcıya ihtiyaç duyduğunu, bir orkestrasyon katmanının gerçekte ne yapması gerektiğini (yönlendirme, güvenli tekrar deneme, mutabakat, taşıma), bunu kendiniz mi yazmanız yoksa hazır mı almanız gerektiğini ve Payrudder’ın konuya nasıl yaklaştığını anlatıyoruz.
SaaS neden birden fazla ödeme sağlayıcısı kullanır?
Çoğu şirket tek sağlayıcıyla başlar ve yıllarca öyle kalır. İkinci sağlayıcı genelde şu sebeplerden biriyle gelir:
- Kapsama. Hiçbir sağlayıcı her ülkeyi, para birimini ve ödeme yöntemini eşit derecede iyi karşılamaz. ABD ve AB’de güçlü bir sağlayıcı, Türk lirasıyla ödeyen müşteriler için zayıf kalabilir; tersi de geçerli.
- Yerel kartlar ve alışkanlıklar. Bazı pazarlarda müşteriler yerel kartlarını ve ödeme seçeneklerini destekleyen yerli bir kuruluşla daha rahat öder. Örneğin iyzico’nun kontrol panelinde taksit ve komisyon ayarları için ayrı bir bölüm var (iyzico yardım merkezi).
- Merchant of record mı, ödeme kuruluşu mu? Paddle gibi bir merchant of record hukuken satıcı olur; satış vergisini, KDV’yi ve chargeback’leri sizin yerinize üstlenir. Ödeme kuruluşu ise bunları sizde bırakır. Birçok şirket yurt dışı satışlar için MoR, iç pazar için daha ucuz bir ödeme kuruluşu ister. Bu seçimi merchant of record nedir yazısında ayrıntılı anlattık.
- Yedeklilik. Bir sağlayıcı hesabınızı dondurursa ya da kesinti yaşarsa, ikincisi yeni satışların devam etmesini sağlar.
- Maliyet. Komisyonlar modele göre çok değişiyor. Paddle’ın kullandıkça öde fiyatı, vergi ve chargeback dahil işlem başına %5 + 50 sent (Paddle fiyatlandırma). iyzico’nun yardım merkezi ise kurumsal satıcılar için %4,29’dan başlayan komisyon ve başarılı işlem başına 0,25 ₺ yazıyor; gerçek oranınız kontrol panelinizde görünüyor (iyzico yardım merkezi). MoR komisyonu vergi işini de kapsadığı için bu rakamlar bire bir kıyaslanamaz, ama pazara göre yönlendirmenin neden önemli olabileceğini gösterir.
İki sağlayıcınız olduğu anda faturalama kodunuz daha önce hiç cevaplamak zorunda kalmadığı sorulara cevap vermek zorunda kalır.
Ödeme orkestrasyonu ne yapmalı?
| İş | Cevapladığı soru | Olmazsa ne olur? |
|---|---|---|
| Yönlendirme | Bu müşteri hangi sağlayıcıyı kullanacak? | Müşteri para birimini çekemeyen bir sağlayıcıya düşer ya da bir kural değişince sessizce taşınır |
| Sahiplik | Bu aboneliği kim yeniliyor, kim tekrar deniyor? | Hem sizin kodunuz hem sağlayıcı tekrar dener, müşteri iki kez ödeme yapar |
| Güvenli tekrar | Bu çekimi tekrar deneyebilir miyiz? | Zaman aşımı hata sanılır ve çekim yeniden gönderilir |
| Mutabakat | Bizim kaydımız sağlayıcınınkiyle tutuyor mu? | Ödenmiş faturalar ödenmemiş görünür, iadeler kaybolur, raporlar lirayla doları toplar |
| Taşıma | Müşteriyi başka sağlayıcıya nasıl taşırız? | İki canlı abonelik ya da hiç abonelik olmayan bir boşluk |
Yönlendirme kuralları: ülke ve para birimi
İşe yarayan en basit yönlendirme kuralı iki şeye bakar: müşterinin ülkesi ve aboneliğin para birimi. Örneğin:
- Ülke TR ve para birimi TRY → iyzico
- Geri kalan her şey → Paddle (varsayılan)
Burada kuralların kendisinden daha önemli iki tasarım kararı var.
Bir kez karar verin, cevabı kaydedin. Sağlayıcı abonelik oluşturulurken seçilmeli ve aboneliğe yazılmalı. Yönlendirme her yenilemede yeniden hesaplanırsa, bir kuralı düzenlemek mevcut müşterileri kayıtlı kartlarının olmadığı bir sağlayıcıya sessizce taşır.
Kuralları sağlayıcının yapabildiklerine göre doğrulayın. GBP aboneliklerini GBP çekemeyen bir sağlayıcıya gönderen kural ilk yenilemede değil, kaydederken hata vermeli.
Sahiplik: her aboneliğe tek motor
Sağlayıcılar abonelik yaşam döngüsünün ne kadarını yürüttükleri konusunda farklıdır. Paddle gibi bir merchant of record genelde yenilemeleri ve başarısız ödeme tekrarlarını kendisi yürütür. iyzico gibi bir ödeme kuruluşu istendiğinde karttan çeker; takvimi ve tekrarları size bırakır.
Orkestrasyon katmanı hangisinin hangisi olduğunu bilmeli ve her aboneliğe yenileme ve tahsilat takibi (dunning) için tek bir sahip atamalı. Hem sizin zamanlayıcınız hem sağlayıcı başarısız bir ödemeyi tekrar denerse, iki çekim ve kızgın bir müşteri elde edersiniz.
Tekrar deneme ve idempotency: asla iki kez çekme
Ödemeler can sıkıcı bir şekilde başarısız olur: bazen başarısız olup olmadığını bilemezsiniz. İstek zaman aşımına uğrar, bağlantı kopar, sağlayıcı cevap verdikten sonra ama cevap kaydedilmeden önce işçi süreç çöker. Körlemesine tekrar denemek müşteriden ikinci kez çekebilir. Vazgeçmek ödenmiş bir faturayı ödenmemiş bırakabilir.
Tekrar denemeyi güvenli kılan kalıplar:
- Durum tablosu olan bir saga. Çekim, kalıcı bir durum makinesindeki adımlardan biridir (fatura, PDF, çekim, makbuz). Her geçiş bir sonraki komut gönderilmeden önce yazılır; çökme olursa bilinen bir durumdan devam edilir.
- Her deneme için tek bir idempotency anahtarı. Her çekim denemesi deterministik bir anahtar alır. Aynı deneme iki kez gelirse sağlayıcı (ya da sizin işçi süreciniz) bunu tanır ve yeniden çekmek yerine ilk sonucu döner. Gerçek bir red sonrası yapılan yeni deneme yeni bir anahtar alır.
- Sonuç bilinmiyorsa önce sorun. Bir çekim zaman aşımına uğrarsa durum “ödeme belirsiz” olur ve sıradaki adım yeniden çekmek değil, sağlayıcıya o denemenin durumunu sormaktır.
- Redleri döngüde değil, takvimle tekrar deneyin. Reddedilen kart saniyeler değil günler sonra yeniden denenir ve sonunda tahsil edilemez olarak işaretlenir.
Mutabakat: tek ödeme defteri
Her sağlayıcı parayı kendi formatında, kendi para biriminde ve kendi zamanlamasıyla bildirir. Orkestrasyonun tek bir ödeme defterine ihtiyacı var: sağlayıcılar arası her çekimin, iadenin ve itirazın sadece eklenen (append-only) bir kaydı; her satır sağlayıcının kendi referansını gösterir.
Bu defterle mutabakat yapabilirsiniz: ödenmiş her faturanın karşılığında bir çekim, her çekimin de bir faturası olduğunu kontrol eder, farkları sessizce düzeltmek yerine raporlarsınız. Sağlayıcı webhook’ları doğrulanmalı ve bir şeyi değiştirmeden önce sağlayıcıya teyit ettirilmeli; çünkü webhook bir ipucudur, kanıt değil. Raporlar sağlayıcı, ülke ve para birimine göre ayrılmalı; açık bir kur girilmeden iki para birimi asla toplanmamalı.
Abonelikleri sağlayıcılar arasında taşımak
Er ya da geç müşterilerinizi taşımak isteyeceksiniz: daha ucuz bir sağlayıcı, yeni bir pazar ya da hesabınızı kapatan bir sağlayıcı yüzünden. Kart bilgileri bir sağlayıcıdan diğerine kopyalanamaz; bu yüzden taşıma her zaman müşterinin yeni sağlayıcının formunda ödeme yöntemini girmesini gerektirir.
Güvenli bir taşıma da bir sagadır:
- Müşteriyi yeni sağlayıcıda oluşturun ve barındırılan formdan ödeme yöntemini alın.
- Yeni aboneliği, müşterinin zaten ödediği dönemin sonuna hizalı oluşturun.
- Eski aboneliği ancak yeni sağlayıcı onayladıktan sonra iptal edin.
Bütün mesele sıralamada. 3. adımdan önce bir şey ters giderse eski abonelik olduğu gibi çalışmaya devam eder. Müşteri hiçbir zaman iki canlı abonelikte ya da aboneliksiz kalmaz.
Kendiniz mi yazmalısınız, hazır mı almalısınız?
Ödeme orkestrasyonunu kendiniz yazabilirsiniz. Yazan ekipler genelde mutlu yolun ötesini hafife alır: belirsiz sonuç, iki kez gelen webhook, taşıma, ay sonunda muhasebenin istediği mutabakat raporu.
| Soru | Kendiniz yazın | Orkestrasyon katmanı kullanın |
|---|---|---|
| İlk sağlayıcı | Hızlı | Benzer emek |
| İkinci sağlayıcı | İkinci bir akış, webhook ve uç durum seti | Bir adaptör ve bir yönlendirme kuralı |
| Çift çekim güvenliği | Siz tasarlar, siz test edersiniz | Katmanla gelir; nasıl test edildiğine bakın |
| Mutabakat ve raporlar | Genelde geç yazılır | Katmanın parçası |
| Kontrol ve verinin yeri | Tamamen sizde | Sağlayıcıya göre değişir |
| Süregelen maliyet | Mühendis zamanı | Abonelik ücreti |
Ödeme sizin ürününüzse ya da tek sağlayıcı size her zaman yetecekse kendiniz yazmak mantıklı. Asıl ürününüzü geliştirip yine de iki sağlayıcıyla satmak istiyorsanız hazır bir katman almak mantıklı.
Payrudder ödeme orkestrasyonunu nasıl yapıyor?
Payrudder, Go ile yazılmış bir kullanım ölçümü, abonelik faturalama ve ödeme orkestrasyonu platformu. Orkestrasyon tarafı şöyle çalışıyor:
- Sağlayıcılar ne yaptığını beyan ediyor. Her adaptör sağlayıcının neyi yaptığını söylüyor: yenilemeyi mi yürütüyor, tahsilat takibini mi, vergiyi mi hesaplıyor, ödeme sayfasını mı barındırıyor, kendi makbuzunu mu gönderiyor, iade API’si var mı, hangi para birimlerinde çekim yapabiliyor. Gerisini Payrudder yapıyor. Paddle (merchant of record) yenilemeleri ve tekrarları kendisi yürütüyor; iyzico için çekimleri ve tekrarları Payrudder planlıyor; banka havalesi sağlayıcısı müşteriye nereye ödeyeceğini söyleyip onayı bekliyor. Sandbox ortamında yerleşik bir simülatör çalışıyor.
- Her aboneliğe tek sahip, sağlayıcının beyanından alınıyor; böylece iki motor aynı ödemeyi asla birlikte denemiyor. Paddle kendi makbuzunu gönderdiği için Payrudder, Paddle’ın tahsil ettiği ödemelere ikinci bir makbuz göndermiyor.
- Müşteri ülkesi ve para birimine göre yönlendirme kuralları: sıralı, ilk eşleşen kazanır, bir varsayılan var; abonelik oluşturulurken bir kez değerlendirilip aboneliğe kaydediliyor. O para biriminde çekim yapamayan bir sağlayıcıyı gösteren kural kaydedilirken reddediliyor.
- Asla iki kez çekmemek: durum tablosu olan orkestre edilmiş bir saga, deterministik komut kimlikleri, her deneme için tek idempotency anahtarı ve sonuç belirsizse tekrar denemeden önce sağlayıcıya sorma. Bu; rastgele cevaplı testler, “ödeme belirsiz” senaryoları ve ay kapanışının ortasında mesaj kuyruğunun yeniden başlatılmasıyla test ediliyor.
- Faturalarla mutabakatı yapılan bir ödeme defteri, doğrulanan ve sağlayıcıya teyit ettirilen webhook’lar, sağlayıcı, ülke ve para birimine göre raporlar (gelir, MRR, ödenmemiş faturalar).
- Abonelikleri sağlayıcılar arasında taşıma, ikisi aynı anda canlı olmadan.
Dürüst bir sınır: Paddle ve iyzico adaptörleri sağlayıcıların dokümantasyonundan yazıldı ve kayıtlı örnek yanıtlarla test edildi. Henüz sağlayıcıların sandbox ortamlarında çalıştırılmadılar. Onları “yazıldı” diye düşünün, “üretimde kanıtlandı” diye değil.
Ayrıntılar ödeme orkestrasyonu sayfasında. Türkiye’den hem yerli hem yabancı müşterilere satıyorsanız Türkiye’den SaaS satmak sayfasına da bakın.
Özet
Ödeme orkestrasyonu, “iki sağlayıcı kullanıyoruz” cümlesini bir yığın özel durumdan tek bir faturalama sistemine çevirir: ülke ve para birimine göre bir kez yönlendirin, her aboneliğe tek sahip verin, her çekim denemesini idempotent yapın, belirsiz sonuçta tekrar denemeden önce sorun, tek defter tutun ve yeni sağlayıcı onaylamadan taşıma yapmayın.
Payrudder Cloud erken erişimde ve gelirinizden pay alarak değil, sistem kullanımına göre ücretlendiriliyor. Fiyatlar sayfasına göz atın.