Stripe Ödemeleri

1Bu, uygulamanıza ne kazandırır#

Oluşturduğunuz uygulamaların Stripe Checkout ile gerçek para almasını sağlar - ödeme duvarları, 'Pro' yükseltmeleri, satın alma düğmeleri.

Bu SİZİN Stripe hesabınızdır: anahtarlarınız sizin, paranız sizin, ödeme doğrudan size gider. AppMint komisyon almaz ve ödeme sorumluluğu üstlenmez (Stripe Connect yoktur). Stripe'ı Ayarlar'da BİR KEZ bağlarsınız; oluşturduğunuz her uygulama bunu kullanır - yalnızca ne satacağınızı anlatırsınız, anahtarları yeniden girmezsiniz.

Yapay zekâ tüm ödeme kodunu yazar. Gizli anahtarınız uygulamanın içinde asla gönderilmez - Supabase arka ucunuzda durur.

2Önce Supabase'i bağlayın (zorunlu)#

Stripe ödemeleri, gizli anahtarınızı tutmak ve ödemeleri onaylamak için güvenli bir sunucuya ihtiyaç duyar - bu sunucu sizin Supabase projenizdir. Bu yüzden önce Supabase'i bağlayıp etkinleştirin (Ayarlar → BACKEND - SUPABASE) - bu rehberin başındaki '🗄️ Supabase Backend (Bir Kez Bağlayın)' bölümü adım adım anlatır.

Supabase etkin değilse 'Stripe anahtarları kaydedildi, ancak ödemeler için Supabase de etkin olmalı' mesajını görürsünüz. AppMint, dağıtım sırasında Stripe gizli anahtarınızı Supabase işlevlerinize otomatik olarak gönderir - oluşturulan uygulamaya asla konmaz.

3Stripe anahtarlarınızı alın (testle başlayın)#

Bir bilgisayarda:

1. Stripe Dashboard'u açın ve geliştirirken test modunda / sandbox'ta kalın (Stripe artık test ortamına 'sandbox' diyor; eski hesaplarda Test/Live anahtarı görünür). Burada gerçek ödeme alınmaz.
2. Developers → API keys bölümüne gidin.
3. 'Publishable key' değerini (pk_test_… ile başlar) kopyalayın ve 'Secret key' değerini (sk_test_… ile başlar) gösterip kopyalayın.

Kısıtlanmış anahtar (rk_…) değil, standart Gizli anahtarı (sk_…) kullanın - AppMint sk_ gizli anahtarını doğrular ve gönderir. Canlı ödemeleri etkinleştirmeden önce tüm akışı oluşturmak ve test etmek için satıcı onayı gerekmez.

Stripe API anahtarlarını aç →

4Stripe'ı AppMint'e bağlayın#

AI Studio'yu açın → Ayarlar → 'PAYMENTS - STRIPE (OPTIONAL)' bölümüne kaydırın → 'CONNECT STRIPE (YOUR ACCOUNT)':

1. 'Canlı mod'u şimdilik KAPALI bırakın (kapalı = Test).
2. Yayınlanabilir anahtarınızı pk_test_… alanına yapıştırın.
3. Gizli anahtarınızı sk_test_… alanına yapıştırın (bu cihazda şifreli tutulur).
4. 'Oluşturulan uygulamalar için Stripe ödemelerini etkinleştir' seçeneğini AÇIN.
5. 'Stripe anahtarlarını doğrula ve kaydet'e dokunun. AppMint biçimi kontrol eder, iki anahtarın aynı modda olduğundan emin olur ve gizli anahtarı Stripe ile doğrular. Başarılı olursa '● Bağlı (TEST)' görürsünüz.

5AppMint sizin için neleri bağlar#

Ödemeli bir uygulama oluşturduğunuzda AppMint tüm altyapıyı otomatik kurar - Supabase veya Stripe panellerine dokunmanız gerekmez:

• STRIPE_SECRET_KEY değerinizi Supabase Edge Functions'a gönderir (şifreli, yalnızca sunucu tarafında).
• Bir 'create-checkout' işlevi (Stripe Checkout oturumu başlatır) ve bir 'stripe-webhook' işlevi (ödemeleri onaylar) dağıtır.
• Webhook'u Stripe'a kaydeder ve imza gizli anahtarını saklar.
• Kimin ödeme yaptığını uygulamanın bilmesi için bir 'entitlements' tablosu oluşturur.

Yayınlanabilir anahtar (pk_), uygulamayla birlikte gönderilen tek Stripe değeridir - bu anahtarın herkese açık olması güvenlidir.

6Ödeme duvarınızı anlatın - yapay zekâ oluşturur#

Ne istediğinizi düz Türkçeyle söylemeniz yeterli. Yapay zekâ satın al düğmesini, ödeme çağrısını ekler ve ücretli özellikleri sizin için kilitler:

• 'Pro temasının kilidini açmak için tek seferlik 5 $ ücret al.'
• 'Reklamları kaldıran aylık 9 $'lık abonelik.'
• '19 $'a indirilebilir bir PDF sat.'

Anahtarları veya fiyatları yapılandırma olarak sohbete yapıştırmazsınız - yalnızca niyetinizi yazarsınız. Erişim, yalnızca Stripe ödemeyi webhook ile onayladıktan sonra açılır; istemci tarafındaki bir 'ödendi' bayrağıyla asla açılmaz, bu yüzden taklit edilemez.

7Ödemeyi uçtan uca test edin#

Test modundayken gerçek para hareketi olmaz. Tüm akışı deneyin:

1. Uygulamanızı açın ve satın al/yükselt düğmesine dokunun.
2. Stripe Checkout sayfasında test kartıyla ödeme yapın:

 4242 4242 4242 4242, any future expiry, any CVC, any ZIP.

1. Uygulamaya geri dönersiniz ve ücretli özelliğin kilidi açılır.
2. Stripe Dashboard'u (Test modu) → Payments bölümünden kontrol edin - test ödemesini göreceksiniz.

Kilit açılırsa webhook'unuz ve yetkilendirmeleriniz doğru bağlanmış demektir.

4242 4242 4242 4242   exp: any future date   CVC: any 3 digits

8Hazır olduğunuzda canlıya geçin#

1. Canlı ödemeler için Stripe hesabınızı etkinleştirin (Stripe Dashboard → 'Activate' / işletme bilgilerini tamamlayın).
2. Stripe'ta sandbox/test modundan canlı moda geçin ve CANLI anahtarlarınızı (pk_live_… ve sk_live_…) Developers → API keys bölümünden kopyalayın.
3. AppMint → Ayarlar → Ödemeler'de: 'Canlı mod'u AÇIN, pk_live_/sk_live_ anahtarlarını yapıştırın ve 'Doğrula ve kaydet'e dokunun. Rozet '● Bağlı (CANLI)' olur.
4. Uygulamanızı yeniden derleyin.

AppMint test ve canlı anahtarların karıştırılmasını engeller; mod değiştirmek dağıtılmış gizli anahtarı yeniden yönlendirir - test ve canlı bir uygulamada asla bir arada bulunmaz, böylece yanlışlıkla test anahtarlarını yayınlayamazsınız.

9Bir şey çalışmazsa#

• 'Stripe anahtarları kaydedildi, ancak ödemeler için Supabase de etkin olmalı' → önce Supabase'i etkinleştirin (2. adım).

• 'TEST seçtiniz ama anahtarlar CANLI' (veya tersi) → mod anahtarı, anahtarlarınızın önekiyle (pk_test/sk_test veya pk_live/sk_live) eşleşmelidir.

• 'Stripe anahtarı reddetti' → gizli anahtar yanlış veya iptal edilmiş. Developers → API keys bölümünden yeniden kopyalayın.

• Ödeme başarılı ama özellik kilitli kalıyor → webhook Supabase'e ulaşmadı. AppMint'in webhook'u yeniden kaydetmesi için yeniden derleyin/dağıtın ve uygulamanın Supabase projesinin bağladığınız proje olduğunu doğrulayın.

• Canlı hesap etkinleştirilemiyor → Stripe bazı ülkelerde (Hindistan dahil) satıcı kaydı yapmaz. Test modu geliştirme için her yerde çalışır; oradaki canlı ödemeler için Stripe'ın desteklediği bir ülke veya farklı bir sağlayıcı gerekir.