💳 Ödeme Ayarları
Ödeme ayarları, uygulamanızın desteklediği ödeme ağ geçitlerini yapılandırmanıza olanak tanır. Kullanıcılar bu ağ geçitlerini uygulama içinde jeton ve elmas satın almak için kullanır; ardından bunları hediye göndermek, premium özelliklere erişmek ve daha fazlası için kullanırlar.
Erişim Yolu
Ayarlar ← Ödeme
Desteklenen Ödeme Ağ Geçitleri
Sistem aşağıdaki ödeme ağ geçitlerini destekler. Her ağ geçidi bağımsız olarak etkinleştirilebilir veya devre dışı bırakılabilir:
1. Stripe
Stripe, çoğu ülkede kredi/banka kartları ve çeşitli ödeme yöntemlerini destekleyen küresel bir ödeme platformudur.
| Alan | Açıklama | Zorunlu |
|---|---|---|
| Secret Test Key | Stripe gizli anahtarınız (test için sk_test_ ile veya üretim için sk_live_ ile başlar) |
✅ Evet |
| Success URL | Başarılı bir ödemeden sonra kullanıcıların yönlendirileceği URL | ✅ Evet |
| Cancel URL | Kullanıcılar ödemeyi iptal ederse yönlendirileceği URL | ✅ Evet |
| Currency | İşlemler için para birimi (örn., usd, eur, sar) |
✅ Evet |
| Webhook Secret Key | Webhook olaylarını doğrulamak için Stripe'dan alınan webhook imza gizli anahtarı (whsec_ ile başlar) |
✅ Evet |
| Webhook URL | Stripe ödeme olaylarını alan sunucu uç noktanız: BASE_URL/api/stripe-callback |
✅ Evet |
Stripe Kimlik Bilgilerini Nasıl Alırsınız
- https://dashboard.stripe.com adresine gidin ve bir hesap oluşturun veya giriş yapın.
- Gizli Anahtarınızı bulmak için Developers → API Keys bölümüne gidin.
- Webhook uç noktanızı kurmak ve Webhook Secret Key'i almak için Developers → Webhooks bölümüne gidin.
- Geliştirme sırasında test anahtarlarını (
sk_test_...) kullanın ve üretime geçtiğinizde canlı anahtarlara (sk_live_...) geçin.
2. Fawry
Fawry, Mısır ve Orta Doğu'da popüler bir ödeme ağ geçididir. Fawry referans numaraları, kredi kartları ve mobil cüzdanlar dahil çeşitli yerel ödeme yöntemlerini destekler.
| Alan | Açıklama | Zorunlu |
|---|---|---|
| Server Secret | API isteklerini doğrulamak için Fawry sunucu gizli anahtarınız | ✅ Evet |
| Merchant Code | Fawry tarafından sağlanan benzersiz satıcı tanımlayıcınız | ✅ Evet |
| URL | Ödemeleri başlatmak için Fawry API uç noktası (örn., https://atfawry.fawrypay.com/fawrypay-api/api/payments/init) |
✅ Evet |
| Return URL | Ödeme tamamlandıktan sonra kullanıcıların yönlendirileceği URL: BASE_URL/api/utd-fawry-callback |
✅ Evet |
| Webhook URL | Fawry ödeme bildirimleri için sunucu uç noktanız: BASE_URL/api/fawry-callback |
✅ Evet |
Fawry Kimlik Bilgilerini Nasıl Alırsınız
- https://atfawry.fawrypay.com adresinden Fawry satıcı hesabına kaydolun.
- Onaylandıktan sonra Merchant Code ve Server Secret bilgilerinizi alacaksınız.
- Test için hazırlık URL'sini, canlı ödemeler için üretim URL'sini kullanın.
Ödeme Ağ Geçidini Etkinleştirme
- Ayarlar'da Ödeme sekmesine gidin.
- Etkinleştirmek istediğiniz ödeme ağ geçidini bulun.
- Etkinleştirmek için anahtarı AÇIK (yeşil) konumuna getirin.
- Ağ geçidi için gerekli tüm kimlik bilgilerini ve URL'leri doldurun.
- Yapılandırmayı uygulamak için "Kaydet" düğmesine tıklayın.

Ödeme Ağ Geçidini Devre Dışı Bırakma
- Devre dışı bırakmak istediğiniz ağ geçidi için anahtarı KAPALI konumuna getirin.
- "Kaydet" düğmesine tıklayın.
Uyarı
Bir ödeme ağ geçidini devre dışı bırakmak, kullanıcıların o ağ geçidi üzerinden ödeme yapmasını anında engelleyecektir. En az bir ağ geçidinin aktif kaldığından emin olun.
Yapılandırma Sonrası Test
Bir ödeme ağ geçidini yapılandırdıktan sonra şunların yapılması önerilir:
- Ağ geçidinin doğru çalıştığını doğrulamak için uygulama üzerinden küçük bir test ödemesi yapın.
- Ödemenin ağ geçidi kontrol panelinizde (Stripe Dashboard veya Fawry Dashboard) göründüğünü kontrol edin.
- Jetonların/elmasların test kullanıcısının hesabına doğru şekilde yüklendiğini doğrulayın.
- Webhook uç noktasının ödeme onaylarını aldığını kontrol edin.
İpuçları
- İlk kurulum sırasında her zaman test/hazırlık kimlik bilgilerini kullanın, ardından canlıya geçmeye hazır olduğunuzda üretim kimlik bilgilerine geçin.
- Gizli anahtarlarınızı ve webhook sırlarınızı gizli tutun — asla herkese açık paylaşmayın.
- Webhook URL'lerinizin internetten erişilebilir olduğundan emin olun (güvenlik duvarı veya VPN arkasında olmadığından).
- İşlemleri takip etmek ve sorunları tespit etmek için ödeme ağ geçidi kontrol panellerinizi düzenli olarak izleyin.