Paywall Cursor Rules Nedir?
Paywall Cursor Rules, Paywall ödeme altyapısının tüm API dokümantasyonunu Cursor IDE’nin yapay zeka asistanına entegre eden bir kural setidir. Geliştiriciler, ödeme servisleri, webhook yönetimi, tekrarlı ödemeler ve marketplace süreçleriyle ilgili kod yazarken Cursor’a soru sorduklarında, yapay zeka artık genel bilgiyle değil Paywall’ın güncel ve doğru dokümantasyonuyla yanıt verir.
Geleneksel yöntemde geliştiriciler API dokümanları arasında gezinip ilgili bilgiyi bulmak, kod örneklerini kendi projelerine uyarlamak ve entegrasyon detaylarını manuel olarak takip etmek zorundadır. Paywall Cursor Rules bu süreci tersine çevirir: dokümantasyon projenize gelir, siz sadece sormanız gereken soruyu sorarsınız.
Tek bir komutla kurulan bu yapı, yüzlerce API dokümanını ve modül bazlı kural dosyasını .cursor/rules/ klasörüne yerleştirir. Cursor AI, sorduğunuz konuya göre yalnızca ilgili kuralları otomatik olarak devreye alır; ödeme akışlarıyla ilgili bir soru sorduğunuzda ödeme servisi kuralları, webhook hatalarıyla ilgili bir soru sorduğunuzda ise webhook ve hata yönetimi kuralları context’e dahil edilir.
Cursor .mdc Kuralları Nedir ve Ne İşe Yarar?
.mdc uzantılı dosyalar, Cursor IDE’nin yapay zeka modeline bağlam (context) sağlamak için kullandığı kural dosyası formatıdır. YAML frontmatter yapısı sayesinde her kural dosyasının ne zaman, hangi koşullarda ve hangi kapsamda devreye gireceği tanımlanabilir.
Paywall’ın sunduğu .mdc kuralları iki kategoriye ayrılır:
- Her zaman aktif kurallar: paywall-core.mdc gibi temel authentication, ortam ayarları ve genel mimari bilgilerini içeren dosyalar her sorguda devreye girer.
- Otomatik tetiklenen kurallar: Ödeme servisi, tekrarlı ödeme, pazaryeri, payout, cüzdan ve webhook-hata gibi modül bazlı kurallar, yalnızca ilgili konu sorulduğunda devreye girer.
Bu mimari, Cursor AI’ın gereksiz bilgiyle yüklenmeden, sorunun bağlamına en uygun ve en güncel dokümantasyonla yanıt vermesini sağlar. Sonuç olarak yapay zekanın ürettiği kod önerileri ve açıklamalar, gerçek API davranışıyla birebir örtüşür.
Yapay Zeka (AI) Destekli Ödeme Orkestrasyonu
Ödeme sistemleri; çoklu banka entegrasyonları, 3D Secure akışları, taksit yapıları, abonelik döngüleri ve marketplace komisyon hesaplamaları gibi pek çok hareketli parçayı bir arada yönetmeyi gerektirir. Bu karmaşıklığı manuel olarak takip etmek, geliştirme sürecini yavaşlatır ve hata riskini artırır.
Paywall, finans sektöründeki bu karmaşıklığı ödeme orkestrasyonu yaklaşımıyla tek bir altyapı üzerinden yönetilebilir hale getirir; Akbank, Garanti BBVA, YapıKredi, DenizBank, İş Bankası, Ziraat, Vakıfbank, Halkbank, ING, TEB, QNB, KuveytTürk ve Fibabanka gibi bankalarla kurulu entegrasyonları tek bir API üzerinden erişilebilir hale getirir. Cursor Rules entegrasyonu, bu orkestrasyon katmanını yapay zeka destekli geliştirme deneyimiyle birleştirir; geliştirici hangi banka, hangi ödeme yöntemi veya hangi modülün kullanılacağını Cursor AI’a sorarak öğrenebilir ve kodunu buna göre şekillendirebilir.
Paywall Kurallarını Cursor’a Nasıl Kurarsınız?
Adım Adım Kurulum Rehberi
Kurulum süreci üç basit adımdan oluşur:
- Komutu çalıştırın. Terminalinizde işletim sisteminize uygun komutu çalıştırın:
- macOS / Linux: curl -sSL https://cursor.paywall.one/install.sh | bash
- Windows: iex (iwr https://cursor.paywall.one/install.ps1).Content
- Bu komut, .cursor/rules/ ve paywall-docs/ klasörlerini projenize otomatik olarak ekler.
- Cursor’ı açın. Cursor IDE, projenizdeki kural dosyalarını otomatik olarak algılar ve yapay zeka context’ine dahil eder. Ekstra bir yapılandırma yapmanıza gerek kalmaz.
- Sorularınızı sormaya başlayın. Paywall API’siyle ilgili sorularınızı doğrudan Cursor AI’a sorun. Ödeme akışı oluşturma, webhook dinleme, abonelik kurma gibi konularda doğru ve güncel cevaplar alırsınız.
Kurulumla birlikte yüzlerce API dokümanı, modül bazlı kural dosyaları ve desteklenen programlama dillerine ait hazır kod örnekleri projenize indirilir.
Paywall Cursor Rules ile Neler Yapabilirsiniz?
Ödeme Akışları
3D Secure ve Non-Secure ödeme akışlarını, iade ve iptal işlemlerini, taksitli ödeme yapılarını Cursor AI’a sorarak doğrudan kod düzeyinde uygulayabilirsiniz. Yapay zeka, hangi endpoint’in hangi parametrelerle çağrılması gerektiğini güncel dokümantasyona dayanarak önerir.
Webhook Yönetimi
Callback endpoint’lerinin nasıl kurulacağı, hangi event tiplerinin dinleneceği ve hata kodlarının nasıl yorumlanacağı konusunda Cursor AI size adım adım rehberlik eder. Webhook doğrulama sürecini de güncel örneklerle birlikte alabilirsiniz.
Tekrarlı Ödemeler ve Abonelikler
Abonelik planı oluşturma, deneme süreleri tanımlama, otomatik tahsilat döngülerini yönetme ve abonelik iptali gibi senaryoları, ilgili modül kuralları otomatik devreye girerek size doğru kod örnekleriyle rehberlik eder.
Marketplace ve Payout Süreçleri
Pazaryeri modelinde satıcı kazançlarının takibi, komisyon hesaplamaları, borç yönetimi ve IBAN üzerinden para çekme (payout) işlemleri gibi çok adımlı süreçleri Cursor AI üzerinden hızlıca kavrayabilir ve uygulayabilirsiniz.
Modül Bazlı Kurallar
Paywall Cursor Rules, her biri belirli bir konuya odaklanan yedi ayrı kural dosyasından oluşur. Bu modülerlik, Cursor AI’ın yalnızca ilgili bilgiyi yüklemesini sağlayarak hem performansı hem de yanıt doğruluğunu artırır.
Ödeme Servisi
odeme-servisi.mdc dosyası; 3D Secure, Non-Secure ödeme, iade, iptal ve taksit işlemlerine dair tüm detayları kapsar. Temel ödeme entegrasyonu yapan her proje için otomatik olarak devreye girer.
Tekrarlı Ödeme
tekrarli-odeme.mdc dosyası, subscription ve abonelik yönetimi süreçlerini içerir. Periyodik tahsilat, plan değişikliği ve abonelik durumu yönetimi gibi konularda referans olarak kullanılır.
Pazaryeri
pazaryeri.mdc dosyası, marketplace modelinde kazanç yönetimi ve borç takibi süreçlerini kapsar. Çok satıcılı platformlar geliştiren ekipler için kritik bir kaynaktır.
Payout
payout.mdc dosyası, para çekme işlemleri ve IBAN üzerinden gerçekleştirilen transferlerle ilgili tüm API detaylarını içerir.
Cüzdan
cuzdan.mdc dosyası, cüzdan servislerini ve bakiye yönetimi süreçlerini kapsar. Kullanıcı veya satıcı cüzdanı tutan uygulamalar için gerekli kuralları sağlar.
Webhook ve Hata Yönetimi
webhook-hata.mdc dosyası, callback endpoint yapılarını ve olası hata kodlarının anlamlarını detaylandırır. Entegrasyon sürecinde karşılaşılan hataların hızlı şekilde tespit edilip çözülmesine yardımcı olur.
Tüm bu modüller, yalnızca konuyla ilgili soru sorulduğunda otomatik olarak aktive olur; paywall-core.mdc ise authentication ve ortam ayarları gibi temel bilgileri her zaman context’te tutar.
Desteklenen Programlama Dilleri
Paywall Cursor Rules, geliştiricilerin kullandığı teknoloji yığınından bağımsız olarak çalışacak şekilde tasarlanmıştır. Aşağıdaki dillerde hazır kod örnekleri sunulur:
- C#
- Go
- Java
- PHP
- Python
- Ruby
- TypeScript
- cURL
Hangi dilde geliştirme yapıyor olursanız olun, Cursor AI sorduğunuz soruya o dile uygun, çalıştırılabilir kod örnekleriyle yanıt verir. Bu sayede ekipler, kullandıkları programlama dili ne olursa olsun aynı dokümantasyon kaynağından tutarlı sonuçlar elde eder.