Giriş
🎯 Bu modül ne yapar?
Payments modülü, e-ticaret mağazanız için ödeme işlemlerini ve işlemleri yönetmenizi sağlar. Ödemeler ve işlemlerle çalışmak, herhangi bir e-ticaret projesinin önemli bir parçasıdır. Ödeme oturumlarını, işlem takibini ve ödeme durumu yönetimini ele almak için Stripe gibi ödeme geçitleri ile entegre olur.
Bunu ödeme yönetim sisteminiz olarak düşünün - OneEntry yönetim panelinde (Payments > Accounts) ödeme hesaplarını yapılandırır, bir ödeme sistemi bağlamak veya nakit ödemeler eklemek gibi farklı ödeme türleri için birden fazla hesap oluşturursunuz ve bu modül ödeme oturumu oluşturma, durum takibi ve işlem yönetimini üstlenir.
📖 Basit Açıklama
Her e-ticaret uygulaması güvenli ödeme işlemlerine ihtiyaç duyar:
- 💳 Ödemeleri Kabul Et - Kredi kartları, banka kartları, dijital cüzdanlar
- 🔒 Güvenli İşlem - PCI uyumlu ödeme işlemleri
- 🔄 Ödeme Durumu - Bekleyen, tamamlanan, başarısız, iade edilen işlemleri takip et
- 💰 İadeler - Tam veya kısmi iadeleri işleme al
- 📊 Ödeme Geçmişi - Tüm işlemleri görüntüle
- 🔗 Geçit Entegrasyonu - Stripe, PayPal, özel geçitler
Manuel ödeme işlemlerinin sorunu:
Sorunlar:
- 🔒 Güvenlik riski - Hassas kart verilerini depolamak
- 📋 PCI uyumluluğu - Pahalı sertifikasyon gereklidir
- 💸 İade takibi yok - Manuel iade yönetimi
- 🔄 Ödeme geçmişi yok - İşlemleri takip etmek zor
Payments çözümü:
Faydalar:
- 🔒 PCI uyumlu - Güvenli tokenize edilmiş ödemeler
- 📊 Ödeme takibi - Tam işlem geçmişi
- 🔄 Otomatik iadeler - Kolay iade işlemleri
- 💸 Birden fazla geçit - Stripe, PayPal, özel
✨ Temel Kavramlar
Ödeme Nedir?
Bir Ödeme, aşağıdakileri içeren bir finansal işlem kaydıdır:
- Ödeme Yöntemi - Kart, PayPal, banka havalesi
- Tutar - İşlem tutarı ve para birimi
- Sipariş Referansı - İlişkili sipariş kimliği
- Ödeme Durumu - Bekleyen, tamamlanan, başarısız, iade edilen
- Geçit Detayları - Stripe işlem kimliği, PayPal referansı
- Müşteri Bilgileri - Fatura detayları
- Zaman Damgaları - Oluşturulma, işlenme, tamamlama tarihleri
Mevcut Hesap Türleri
| Tür | Ne Zaman Kullanılır | Gerekli Yapılandırma |
|---|---|---|
| Stripe | Stripe ödeme sistemini projenize bağlamak için | Stripe hesabı, URL'ler |
| Özel | Alternatif ödeme sistemleri veya nakit ödemeler için | Özel yapılandırma |
Ödeme Yaşam Döngüsü
1. Yönetim panelinde ödeme hesabı oluştur
(Stripe veya özel hesabı yapılandır)
↓
2. Müşteri sipariş verir
(Sipariş, Orders modülünde oluşturulur)
↓
3. Ödeme oturumu oluştur
(Payments.createSession(orderId, type))
↓
4. Müşteri ödeme URL'sine yönlendirilir
(Stripe ödeme sayfası veya özel ödeme sayfası)
↓
5. Müşteri ödemeyi tamamlar
(Ödeme geçit tarafından işlenir)
↓
6. Ödeme durumu güncellenir
(bekliyor → bekleyen → ödendi/iptal edildi/süresi dolmuş)
↓
7. Bildirim alınır
↓
8. Sipariş durumu senkronize edilir
(Ödeme durumu sipariş durumu ile bağlantılı)
Ödeme Durumları
Sistem, işlenen işlemin durumunu belirten dört önceden ayarlanmış ödeme durumu içerir:
| Durum | Anlamı | Ne Zaman Oluşur |
|---|---|---|
| Bekleyen | İlk işlem durumu | Ödeme oturumu yeni oluşturuldu |
| Ödendi | Başarıyla tamamlanan işlem | Ödeme geçit tarafından onaylandı |
| İptal Edildi | İşlem iptal edildi | Müşteri ödemeyi iptal etti |
| Süresi Dolmuş | İşlem geçerlilik süresi sona erdi | Oturum zaman aşımına uğradı |
Önemli: Ödeme ayarlarında durum oluşturamaz veya değiştiremezsiniz. Ancak, bu önceden ayarlanmış ödeme durumlarını sipariş depolama durumları ile ilişkilendirerek ödeme ve sipariş sistemleri arasında otomatik senkronizasyonu etkinleştirebilirsiniz.
Ödeme Yöntemleri
| Yöntem | Açıklama | Geçit Desteği |
|---|---|---|
| kredi_kartı | Visa, Mastercard, Amex | Stripe, PayPal |
| banka_kartı | Banka kartları | Stripe, PayPal |
| paypal | PayPal hesabı | PayPal |
| banka_havalesi | Havale, ACH | Özel |
| apple_pay | Apple Pay cüzdanı | Stripe |
| google_pay | Google Pay cüzdanı | Stripe |
| kapıda_nakliye | Kapıda ödeme | N/A |
Neden Payments Modülünü Kullanmalıyım?
| Faydalar | Açıklama |
|---|---|
| PCI Uyumluluğu | Güvenli tokenize edilmiş ödeme işlemleri |
| Geçit Entegrasyonu | Stripe, PayPal yerleşik |
| Ödeme Takibi | Tam işlem geçmişi |
| İade Yönetimi | Kolay tam/kısmi iadeler |
| Dolandırıcılık Koruması | Yerleşik dolandırıcılık tespiti |
| 3D Güvenli | SCA kimlik doğrulama desteği |
| Çoklu Para Birimi | Birden fazla para birimi desteği |
📋 Bilmeniz Gerekenler
Ödeme Hesapları Yönetim Panelinde Oluşturulur
SDK aracılığıyla ödeme hesapları oluşturamazsınız - bunlar OneEntry yönetim panelinde oluşturulur:
OneEntry Yönetim Paneli → Payments → Accounts → Hesap Oluştur → Formu Doldur → "Ekle"ye Tıkla
Oluşturma Süreci:
- Üç zorunlu alanla formu doldurun:
- İsim - Benzersiz olmayan dize tanımlayıcı
- Tür - Aşağıdan seçilir: "Stripe" veya "Özel"
- Token - Benzersiz dize tanımlayıcı
- Hesabı oluşturmak için "Ekle"ye tıklayın
Hesap Yönetimi:
- Düzenleme - Hesabı seçin, düzenleme simgesine tıklayın, isim/tür/token/Stripe parametrelerini değiştirin
- Gizleme - Hesapları sipariş depolama ayar seçimlerinden gizlemek için göz simgesine tıklayın
- Silme - Hesabı seçin, silme simgesine tıklayın, kaldırmayı onaylayın
SDK, ödemeleri almak ve ödeme oturumları oluşturmak için kullanılır, hesapları yönetmek için değil.
Ödeme Hesap Türleri
İki ödeme hesap türü mevcuttur:
| Tür | Açıklama |
|---|---|
| Stripe | Stripe ödeme sistemini bağlamak için bu türü seçin |
| Özel | Alternatif ödeme sistemleri veya nakit ödemeler için |
Stripe'a özel yapılandırma:
- Başarı URL'si - Başarılı ödeme sonrası yönlendirme URL'si
- İptal URL'si - Ödeme iptal edilirse yönlendirme URL'si
- Oturum süresi - Dakika cinsinden oturum zaman aşımı
Ödeme Durumu Senkronizasyonu
Ödeme durumları sipariş depolama durumları ile ilişkilendirilebilir:
OneEntry Yönetim Paneli → Payments → Statuses → Sipariş Depolamasını Seç → Durumları Eşleştir → Kaydet
Durum eşleme iş akışı:
- Payments içindeki Durumlar alt bölümüne gidin
- İstediğiniz sipariş depolama sistemini seçin
- Her önceden ayarlanmış ödeme durumunu karşılık gelen sipariş depolama durumu değeri ile eşleştirin
- Tüm eşlemelerin doğru olduğunu doğrulayın
- Değişiklikleri uygulamak için Kaydet'e tıklayın
Bu, ödeme durumları değiştiğinde sipariş kayıtlarında otomatik durum güncellemelerini sağlar.
Asla Ham Kart Verilerini Saklamayın
KRİTİK: Asla kredi kartı numaralarını, CVV'yi veya tam son kullanma tarihlerini saklamayın.
Neden?
- PCI DSS uyumluluğu güvenli işlem gerektirir
- Kart verilerini saklamak sizi sorumluluğa maruz bırakır
- OneEntry asla ham kart detaylarını saklamaz
💡 Önemli Notlar
Ödeme Hesapları Yönetim Panelinde Oluşturulur
Unutmayın: SDK, ödemeleri almak ve oturumlar oluşturmak için kullanılır, hesap oluşturmak için değil.
Ödeme hesapları oluşturmak/düzenlemek için: OneEntry Yönetim Panelini kullanın.
Ödeme Hesap Yönetimi
Yönetim panelinde hesap oluşturma:
- Payments > Accounts'a gidin
- Formu İsim, Tür ve Token ile doldurun
- Stripe hesapları için Başarı URL'si, İptal URL'si ve Oturum Süresini yapılandırın
- Oluşturmak için "Ekle"ye tıklayın
Hesapları yönetme:
- Düzenle - İsim, tür, token veya Stripe'a özel parametreleri değiştirin
- Gizle - Sipariş depolama ayarlarından gizlemek için göz simgesine tıklayın (silmez)
- Sil - Kullanılmayan hesapları tamamen kaldırın
Önemli: Sadece kullanılmayan hesaplar silinebilir.
Ödeme Durumu Yapılandırması
Önemli: Yönetim panelinde ödeme durumları oluşturamaz veya değiştiremezsiniz. Sistem dört önceden ayarlanmış duruma sahiptir: Bekleyen, Ödendi, İptal Edildi, Süresi Dolmuş.
Durum senkronizasyon iş akışı:
- Payments > Statuses'a gidin
- Sipariş depolama sistemini seçin
- Önceden ayarlanmış ödeme durumlarını sipariş depolama durumları ile eşleştirin
- Değişiklikleri uygulamak için Kaydet'e tıklayın
Bu, ödeme durumları değiştiğinde otomatik sipariş durumu güncellemelerini sağlar.
Oturum Türleri
İki oturum türü mevcuttur:
| Tür | Açıklama |
|---|---|
| oturum | Ödeme bağlantısı ile bir Stripe Checkout sayfası oluşturur |
| niyet | Doğrudan ödeme işlemleri için bir ödeme niyeti oluşturur |
Güvenlik Öncelikli
🔒 Kritik güvenlik kuralları:
- Asla ham kart verilerini saklamayın - Tokenizasyon kullanın
- Sadece HTTPS kullanın - Tüm ödeme sayfaları SSL olmalıdır
- Sunucuda doğrulayın - İstemci tarafı verilerine asla güvenmeyin
- İşlemleri kaydedin - Denetim izi tutun
- Kişisel bilgileri dikkatlice yönetin - Müşteri verilerini koruyun
PCI Uyumluluğu
✅ OneEntry PCI uyumluluğunu sizin için yönetir:
- Tokenize edilmiş ödeme işlemleri
- Güvenli geçit entegrasyonu
- Ham kart verisi saklamaz
- Şifreli iletim
Sizin sorumluluğunuz:
- Ödeme sayfalarında HTTPS kullanın
- Hassas verileri kaydetmeyin
- Güvenlik en iyi uygulamalarına uyun
Ödeme Durumu Anketi
Asenkron ödemeler için durum güncellemeleri için anket yapın:
İade Sınırlamaları
Önemli iade kuralları:
- Sadece tamamlanan ödemeleri iade edebilirsiniz
- Kısmi iadeler orijinal tutarı aşmamalıdır
- Bazı geçitlerin zaman sınırlamaları vardır (örneğin, 180 gün)
- İadeler asenkron (günler alabilir)
📊 Hızlı Referans Tablosu
| Yöntem | Açıklama | Kullanım Durumu |
|---|---|---|
| getAccounts() | Tüm ödeme hesaplarını al | Mevcut ödeme yöntemlerini listele |
| getAccountById() | ID ile ödeme hesabını al | Belirli hesap detaylarını al |
| createSession() 🔐 | Ödeme oturumu oluştur | Sipariş için ödeme bağlantısı oluştur |
| getSessions() 🔐 | Tüm ödeme oturumlarını al (sayfalı) | Ödeme oturumu geçmişini görüntüle |
| getSessionById() 🔐 | ID ile ödeme oturumunu al | Belirli oturum durumunu kontrol et |
| getSessionByOrderId() 🔐 | Sipariş ID'si ile ödeme oturumunu al | Belirli sipariş için ödemeyi bul |
🔐 = Yetkilendirme gerektirir
❓ Sıkça Sorulan Sorular (SSS)
Stripe ödemelerini nasıl ayarlayabilirim?
Yönetim panelinde "Stripe" türünde bir ödeme hesabı oluşturun, ardından Başarı URL'si, İptal URL'si ve Oturum Süresini yapılandırın. Müşterileri Stripe Checkout'a yönlendiren ödeme bağlantıları oluşturmak için createSession() kullanın.
Oturum ve niyet ödeme türleri arasındaki fark nedir?
Bir oturum, yönlendirme URL'si ile bir Stripe Checkout sayfası oluşturur, barındırılan ödeme sayfaları için idealdir. Bir niyet, uygulamanızda doğrudan özel ödeme formu entegrasyonu için bir ödeme niyeti oluşturur.
Birden fazla ödeme yöntemini destekleyebilir miyim?
Evet! Yönetim panelinde birden fazla ödeme hesabı (Stripe, özel, kapıda nakliye) oluşturun. Her sipariş, müşteri seçimlerine göre farklı bir ödeme hesabı kullanabilir.
Ödeme durumlarını sipariş durumlarıyla nasıl ilişkilendiririm?
Yönetim panelinde Payments > Statuses'e gidin, sipariş depolamanızı seçin ve dört önceden ayarlanmış ödeme durumunu (Bekleyen, Ödendi, İptal Edildi, Süresi Dolmuş) karşılık gelen sipariş durumlarıyla eşleştirin. Bu, otomatik senkronizasyonu etkinleştirir.
Bir ödeme oturumu süresi dolarsa ne olur?
Ödeme oturumlarının yapılandırılabilir bir süresi vardır (hesap ayarlarında ayarlanır). Müşteri bu süre içinde ödemeyi tamamlamazsa, oturum durumu "Süresi Dolmuş" olarak değişir ve yeni bir ödeme oturumu oluşturması gerekir.
🎓 En İyi Uygulamalar
- Tokenizasyon kullanın - Her zaman Stripe.js ile kartları tokenize edin
- Tutarları doğrulayın - Toplamları sunucuda kontrol edin, sadece istemcide değil
- Hataları nazikçe yönetin - Kullanıcılar için net hata mesajları
- İşlemleri kaydedin - Tüm ödemelerin denetim izini tutun
- Webhook'ları kullanın - Ödeme durumu güncellemelerini dinleyin
- Test anahtarları ile test edin - Üretimden önce Stripe test modunu kullanın
- 3D Güvenliğini yönetin - SCA kimlik doğrulama akışını uygulayın
- İşlem kimliklerini saklayın - İhtilaflar için geçit referanslarını saklayın
OneEntry yönetim panelinde ödemeler hakkında daha fazla bilgi: https://doc.oneentry.cloudhttps://doc.oneentry.cloud/docs/category/payments
Payments modülünün tanımı
Payments modülü, ödeme işlemlerini ve işlemleri yönetir. Ödeme hesapları ile çalışmak, ödeme oturumları oluşturmak ve ödeme durumlarını takip etmek için araçlar sağlar.
const { Payments } = defineOneEntry( "your-project-url", { "token": "your-app-token" });
🔗 İlgili Belgeler
- OneEntry Yönetim Paneli - Ödemeler - Resmi yönetim paneli belgeleri
- OneEntry Yönetim Paneli - Ödeme Hesapları - Ödeme hesaplarını yapılandır
- OneEntry Yönetim Paneli - Ödeme Durumları - Durum senkronizasyonu
- OneEntry Yönetim Paneli - Stripe Entegrasyonu - Stripe'ı bağla
- Orders Modülü - Sipariş yönetimi ve ödeme
- AuthProvider Modülü - Oturum yetkilendirmesi için gereklidir
- Products Modülü - Satın alınabilir ürünler
- Stripe Belgeleri - Ödeme geçidi entegrasyonu