saas-payments

Name: saas-payments
Author: komunite

90stars9forks

How to install saas-payments?

komunite/tezgah/saas-payments

$npx -y skills add komunite/tezgah --skill saas-payments

Installs into the current project.

Summary

SaaS uygulaması için ödeme ve abonelik sistemi kur. Stripe veya Lemon Squeezy ile checkout, webhook, abonelik yönetimi, fiyatlandırma planları ve müşteri portalı yapılandır. Bu skill'i kullanıcı ödeme, abonelik, fiyatlandırma, Stripe, gelir, plan, subscription veya checkout ile i

Files · 1

View on GitHub

SKILL.md

1	# SaaS Payments — Ödeme ve Abonelik Yönetimi
2
3	Bu skill, bir SaaS uygulamasının ödeme katmanını kurar. Ödeme, SaaS'ın kalbidir — doğru kurulmazsa ya para alırsın ama plan aktifleşmez, ya da plan aktifleşir ama para alınmaz.
4
5	Bağımlılık: Bu skill saas-launcher orkestratör skill'inin Faz 4'üdür. Bağımsız olarak da kullanılabilir. Auth katmanının (saas-auth) tamamlanmış olması gerekir — ödeme sistemi kullanıcı kimliğine bağlıdır.
6
7	Bağlı skill'ler:
8	- saas-auth — Kullanıcı kimliğini sağlar. Checkout öncesi auth kontrolü yapılır.
9	- saas-email — Ödeme onayı, başarısız ödeme bildirimi gibi e-postaları tetikler.
10	- saas-landing-seo — Fiyatlandırma bölümü buradaki plan tanımlarıyla uyumlu olmalı.
11	- saas-api-security — Plan bazlı erişim kontrolü oturumdaki plan bilgisini kullanır.
12
13	---
14
15	## Ödeme Sağlayıcı Seçimi
16
17	### Stripe
18
19	Varsayılan önerimiz. Gerekçeler:
20
21	Güçlü yönleri: Sektör standardı, en iyi dokümantasyon, en düşük komisyon (%2.9 + $0.30/işlem), kapsamlı webhook sistemi, müşteri portalı hazır, test modu ve CLI ile kolay geliştirme, dev ekosistem (faturalandırma, Connect, Tax).
22
23	Zayıf yönleri: Vergi yönetimi ayrı yapılandırılmalı (Stripe Tax ek ücretli veya kendi başına hesaplamalısın). Türkiye'den doğrudan Stripe hesabı açmak kısıtlı olabilir — Stripe Atlas ile ABD LLC kurulması gerekebilir.
24
25	Türkiye bağlamı: Stripe Türkiye'de doğrudan merchant hesabı desteklemiyor (bu durum değişebilir, güncel bilgiyi kontrol et). Seçenekler: Stripe Atlas ile ABD şirketi kurmak, ya da Lemon Squeezy'nin MoR modelini kullanmak. Kullanıcıya bu durumu mutlaka belirt.
26
27	### Lemon Squeezy
28
29	Ne zaman seç: Vergi yönetimiyle uğraşmak istemeyenler için ideal.
30
31	Güçlü yönleri: Merchant of Record (MoR) modeli — KDV, sales tax, GST hesaplama, tahsilat ve beyanı Lemon Squeezy yapar. Türkiye'den global satış yapan founder'lar için büyük avantaj. Herhangi bir ülkeden hesap açılabilir.
32
33	Zayıf yönleri: Daha yüksek komisyon (%5 + $0.50/işlem), Stripe kadar geniş ekosistem yok, dokümantasyon daha sınırlı.
34
35	### Karar Akışı
36
37	- Türkiye'den çalışıyorsan ve ABD şirketin yoksa → Lemon Squeezy (MoR avantajı)
38	- ABD şirketin varsa veya Stripe Atlas kullanıyorsan → Stripe (düşük komisyon, geniş ekosistem)
39	- Dijital ürün satıyorsan (e-kitap, kurs, lisans) → Lemon Squeezy (bu kullanım için optimize)
40	- Karmaşık faturalandırma gerekiyorsa (metered billing, kullanım bazlı) → Stripe (çok daha esnek)
41
42	---
43
44	## Fiyatlandırma Stratejisi
45
46	### Plan Sayısı
47
48	- 2 plan — Çoğu erken aşama SaaS için ideal. Basit karar: ucuz ve pahalı. Kullanıcı hızla seçer.
49	- 3 plan — Klasik "Good-Better-Best" modeli. Orta plan en çok satanı olur (decoy effect). Ama erken aşamada gereksiz karmaşıklık yaratabilir.
50	- 1 plan + ücretsiz katman — En basit model. Freemium veya deneme süresi ile.
51
52	Önerimiz: 2 plan ile başla. İhtiyaç ortaya çıktıkça 3. planı ekle.
53
54	### Fiyat Belirleme
55
56	Bu işte kesin formül yok ama rehber ilkeler:
57
58	- Değer bazlı fiyatla. Maliyetinin üstüne kâr koyma — sunduğun değerin bir kısmını iste. Kullanıcına ayda 10.000 TL tasarruf sağlıyorsan, ayda 500 TL istemek makul.
59	- Yuvarlak sayılar kullan. $19, $49, $99 — psikolojik fiyatlandırma çalışır.
60	- Yıllık indirim sun. Genellikle %15-20 indirim (2 ay ücretsiz eşdeğeri). Yıllık planlar nakit akışını iyileştirir ve churn'ü azaltır.
61	- Ücretsiz deneme vs. Freemium: Deneme süresi (7-14 gün) aciliyet yaratır. Freemium (sınırlı ücretsiz plan) geniş kullanıcı tabanı oluşturur ama dönüşüm oranı genellikle daha düşük.
62
63	### Plan Özellik Matrisi
64
65	Her planın net sınırları olmalı. Sınırlar şu kategorilerden seçilmeli:
66
67	- Kaynak limitleri: Proje sayısı, depolama alanı, takım üyesi sayısı
68	- Kullanım limitleri: API çağrısı, işlem sayısı, e-posta gönderimi
69	- Özellik erişimi: Gelişmiş raporlar, API erişimi, özel entegrasyonlar, öncelikli destek
70	- Destek seviyesi: E-posta desteği vs. canlı destek vs. dedicated account manager
71
72	Her sınır ölçülebilir ve uygulanabilir olmalı. "Sınırsız" vaat etme — ya kaynakların tükenir ya da kötü niyetli kullanım başlar. "Cömert limitler" daha dürüst ve sürdürülebilir.
73
74	---
75
76	## Checkout Akışı
77
78	### Kullanıcı Yolculuğu
79
80	1. Kullanıcı fiyatlandırma sayfasında plan seçer
81	2. Giriş yapmamışsa → login sayfasına yönlendirilir, giriş sonrası checkout'a döner
82	3. Server-side API route'u ödeme sağlayıcıda checkout session oluşturur
83	4. Kullanıcı ödeme sağlayıcının hosted checkout sayfasına yönlendirilir
84	5. Ödeme başarılıysa → başarı sayfasına yönlendirilir
85	6. Ödeme iptal edilirse → fi

People who liked this also viewed

6 picks

Type

saas-payments

90stars9forks

View on GitHub

How to install saas-payments?

komunite/tezgah/saas-payments

$npx -y skills add komunite/tezgah --skill saas-payments

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# SaaS Payments — Ödeme ve Abonelik Yönetimi
2
3	Bu skill, bir SaaS uygulamasının ödeme katmanını kurar. Ödeme, SaaS'ın kalbidir — doğru kurulmazsa ya para alırsın ama plan aktifleşmez, ya da plan aktifleşir ama para alınmaz.
4
5	Bağımlılık: Bu skill saas-launcher orkestratör skill'inin Faz 4'üdür. Bağımsız olarak da kullanılabilir. Auth katmanının (saas-auth) tamamlanmış olması gerekir — ödeme sistemi kullanıcı kimliğine bağlıdır.
6
7	Bağlı skill'ler:
8	- saas-auth — Kullanıcı kimliğini sağlar. Checkout öncesi auth kontrolü yapılır.
9	- saas-email — Ödeme onayı, başarısız ödeme bildirimi gibi e-postaları tetikler.
10	- saas-landing-seo — Fiyatlandırma bölümü buradaki plan tanımlarıyla uyumlu olmalı.
11	- saas-api-security — Plan bazlı erişim kontrolü oturumdaki plan bilgisini kullanır.
12
13	---
14
15	## Ödeme Sağlayıcı Seçimi
16
17	### Stripe
18
19	Varsayılan önerimiz. Gerekçeler:
20
21	Güçlü yönleri: Sektör standardı, en iyi dokümantasyon, en düşük komisyon (%2.9 + $0.30/işlem), kapsamlı webhook sistemi, müşteri portalı hazır, test modu ve CLI ile kolay geliştirme, dev ekosistem (faturalandırma, Connect, Tax).
22
23	Zayıf yönleri: Vergi yönetimi ayrı yapılandırılmalı (Stripe Tax ek ücretli veya kendi başına hesaplamalısın). Türkiye'den doğrudan Stripe hesabı açmak kısıtlı olabilir — Stripe Atlas ile ABD LLC kurulması gerekebilir.
24
25	Türkiye bağlamı: Stripe Türkiye'de doğrudan merchant hesabı desteklemiyor (bu durum değişebilir, güncel bilgiyi kontrol et). Seçenekler: Stripe Atlas ile ABD şirketi kurmak, ya da Lemon Squeezy'nin MoR modelini kullanmak. Kullanıcıya bu durumu mutlaka belirt.
26
27	### Lemon Squeezy
28
29	Ne zaman seç: Vergi yönetimiyle uğraşmak istemeyenler için ideal.
30
31	Güçlü yönleri: Merchant of Record (MoR) modeli — KDV, sales tax, GST hesaplama, tahsilat ve beyanı Lemon Squeezy yapar. Türkiye'den global satış yapan founder'lar için büyük avantaj. Herhangi bir ülkeden hesap açılabilir.
32
33	Zayıf yönleri: Daha yüksek komisyon (%5 + $0.50/işlem), Stripe kadar geniş ekosistem yok, dokümantasyon daha sınırlı.
34
35	### Karar Akışı
36
37	- Türkiye'den çalışıyorsan ve ABD şirketin yoksa → Lemon Squeezy (MoR avantajı)
38	- ABD şirketin varsa veya Stripe Atlas kullanıyorsan → Stripe (düşük komisyon, geniş ekosistem)
39	- Dijital ürün satıyorsan (e-kitap, kurs, lisans) → Lemon Squeezy (bu kullanım için optimize)
40	- Karmaşık faturalandırma gerekiyorsa (metered billing, kullanım bazlı) → Stripe (çok daha esnek)
41
42	---
43
44	## Fiyatlandırma Stratejisi
45
46	### Plan Sayısı
47
48	- 2 plan — Çoğu erken aşama SaaS için ideal. Basit karar: ucuz ve pahalı. Kullanıcı hızla seçer.
49	- 3 plan — Klasik "Good-Better-Best" modeli. Orta plan en çok satanı olur (decoy effect). Ama erken aşamada gereksiz karmaşıklık yaratabilir.
50	- 1 plan + ücretsiz katman — En basit model. Freemium veya deneme süresi ile.
51
52	Önerimiz: 2 plan ile başla. İhtiyaç ortaya çıktıkça 3. planı ekle.
53
54	### Fiyat Belirleme
55
56	Bu işte kesin formül yok ama rehber ilkeler:
57
58	- Değer bazlı fiyatla. Maliyetinin üstüne kâr koyma — sunduğun değerin bir kısmını iste. Kullanıcına ayda 10.000 TL tasarruf sağlıyorsan, ayda 500 TL istemek makul.
59	- Yuvarlak sayılar kullan. $19, $49, $99 — psikolojik fiyatlandırma çalışır.
60	- Yıllık indirim sun. Genellikle %15-20 indirim (2 ay ücretsiz eşdeğeri). Yıllık planlar nakit akışını iyileştirir ve churn'ü azaltır.
61	- Ücretsiz deneme vs. Freemium: Deneme süresi (7-14 gün) aciliyet yaratır. Freemium (sınırlı ücretsiz plan) geniş kullanıcı tabanı oluşturur ama dönüşüm oranı genellikle daha düşük.
62
63	### Plan Özellik Matrisi
64
65	Her planın net sınırları olmalı. Sınırlar şu kategorilerden seçilmeli:
66
67	- Kaynak limitleri: Proje sayısı, depolama alanı, takım üyesi sayısı
68	- Kullanım limitleri: API çağrısı, işlem sayısı, e-posta gönderimi
69	- Özellik erişimi: Gelişmiş raporlar, API erişimi, özel entegrasyonlar, öncelikli destek
70	- Destek seviyesi: E-posta desteği vs. canlı destek vs. dedicated account manager
71
72	Her sınır ölçülebilir ve uygulanabilir olmalı. "Sınırsız" vaat etme — ya kaynakların tükenir ya da kötü niyetli kullanım başlar. "Cömert limitler" daha dürüst ve sürdürülebilir.
73
74	---
75
76	## Checkout Akışı
77
78	### Kullanıcı Yolculuğu
79
80	1. Kullanıcı fiyatlandırma sayfasında plan seçer
81	2. Giriş yapmamışsa → login sayfasına yönlendirilir, giriş sonrası checkout'a döner
82	3. Server-side API route'u ödeme sağlayıcıda checkout session oluşturur
83	4. Kullanıcı ödeme sağlayıcının hosted checkout sayfasına yönlendirilir
84	5. Ödeme başarılıysa → başarı sayfasına yönlendirilir
85	6. Ödeme iptal edilirse → fi

People who liked this also viewed

6 picks

Type