Payment TR Kullanım Kılavuzu

Modül Hakkında

Payment TR, Türkiye'deki 30+ banka ve ödeme kuruluşu için kapsamlı bir ödeme entegrasyon modülüdür. Odoo'nun standart ödeme akışını korurken, Türkiye'ye özel özellikler ekler.

Temel Özellikler

Kurulum

1. Modülü kopyala: payment_tr klasörünü Odoo'nun addons dizinine kopyalayın.
2. Odoo'yu yeniden başlat: --update=payment_tr parametresi ile başlatın veya servisi restart edip Apps menüsünden upgrade yapın.
3. Apps menüsünden yükle: "Apps" menüsüne gidin, "payment_tr" araması yapın ve Install butonuna tıklayın.

İlk Yapılandırma

1. Ödeme Sağlayıcı üzerinde API token ve endpoint'i ayarla
2. Bankalar'ı aktif et
3. Taksit Seçenekleri'ni tanımla
4. Genel Ayarlar'ı kontrol et
5. (Opsiyonel) Müşteri Özel Kuralları ekle

Ödeme Sağlayıcı

Modül kurulumdan sonra otomatik olarak Payment TR isminde bir payment.provider kaydı oluşturur.

Erişim Yolu

Muhasebe → Yapılandırma → Ödeme Sağlayıcıları → Payment TR

Önemli Alanlar

Banka Tanımları

Her banka için POS bilgilerini ve özelliklerini tanımlayın.

Erişim Yolu

Payment TR → Bankalar ve Taksitler → Banka Tanımları

Banka Eklerken Dikkat Edilecekler

• code: Benzersiz olmalı (örn: GARANTI, AKBANK)
• merchant_id, terminal_id, store_key: Bankadan alınan POS bilgileri
• supports_3d: 3D Secure desteklenip desteklenmeyeceği
• supports_installment: Taksit desteği
• bin_ranges: Hangi BIN kodlarının bu bankayı çağıracağı (kart tanıma için)
• state: enabled olmalı (yoksa kart akışında görünmez)

Taksit Seçenekleri

Her banka için standart taksit seçenekleri tanımlayın. Müşteri özel kuralları bu standart taksitleri override eder.

Erişim Yolu

Payment TR → Bankalar ve Taksitler → Taksit Seçenekleri

Örnek Yapılandırma — Garanti

Genel Ayarlar

Modülün genel davranışını kontrol eden ayarlar.

Erişim Yolu

Payment TR → Yapılandırma → Genel Ayarlar

Önemli Ayarlar

• default_bank_id: BIN tanınmadığında kullanılacak varsayılan banka
• show_installment_on_product: Ürün sayfasında taksit tablosu göster
• email_template_*: Ödeme linki/başarı/başarısız e-posta şablonları

Kural Oluşturma — Müşteri Bazlı

Yöntem 1: Müşteri Formundan

1. Satış → Müşteriler menüsünden müşteriyi açın (sadece ana hesap; alt kontaklar otomatik miras alır)
2. Form'da "Ödeme TR Taksit Kuralları" sekmesine geçin
3. Tabloda "Satır Ekle" ile yeni kural ekleyin
4. Alanları doldurun ve kaydedin

Yöntem 2: Bağımsız Menüden

Payment TR → Bankalar ve Taksitler → Müşteri Özel Taksit Kuralları

Kural Alanları

Kural Oluşturma — Kategori Bazlı

Çok sayıda müşteriye aynı kuralı uygulamak istiyorsanız kategori (tag) kullanın.

Erişim Yolları (3 alternatif)

Adımlar

1. Yeni bir etiket oluşturun: Üç yöntemden biriyle:
   • Payment TR → Bankalar ve Taksitler → Müşteri Etiketleri → Yeni
   • Veya Satış → Yapılandırma → Müşteri Etiketleri
   • Veya bir müşteri açıp "Tags" alanına yazıp Enter
2. Etiket formunun altında "Ödeme TR Taksit Kuralları" bölümünde "Satır Ekle" ile kural tanımlayın
3. Müşterileri etikete atayın: Hedef müşterilerin "Tags" alanına aynı etiketi ekleyin. Alt kontaklar otomatik olarak ana hesabın etiketini miras alır.

Hızlı Erişim

Tüm tag bazlı kuralları tek listede görmek için:

Payment TR → Bankalar ve Taksitler → Tag Bazlı Kurallar

Örnek

Tag: Premium Müşteri
Kural 1: Tum bankalar, 12 taksit, %0 faiz
Kural 2: Tum bankalar, 6 taksit, %0 faiz

Bu tag'i taşıyan tüm müşteriler 6 ve 12 taksitte faizsiz ödeyebilir.

Kampanya Tarihli Kurallar

Kampanya tarihi alanlarını doldurarak kuralın sadece belirli bir tarih aralığında geçerli olmasını sağlayabilirsiniz.

Erişim Yolu

Kampanya Oluşturma Adımları

1. Payment TR → Bankalar ve Taksitler → Kampanyalar menüsünü açın
2. Yeni butonuna basın
3. Hedef seçin (partner VEYA kategori — birinden biri zorunlu)
4. Banka, taksit sayısı, faiz oranı girin
5. Kampanya Tarihi bölümünde date_start ve date_end doldurun
6. Kaydedin — kampanya otomatik aktif olur

Örnek 1: Belirli Müşteri için Kampanya

Örnek 2: Tüm Müşteriler için Kampanya

Genel bir kampanya için (örn. "Anneler Günü tüm müşterilere"):

1. Önce bir "Genel Kampanya" tag'i oluşturun
2. Tüm müşterilere bu etiketi atayın (toplu işlem ile)
3. Bu tag için kampanya kuralı tanımlayın

Kampanyayı İzleme

Kampanyalar listesinde renk göstergeleri:

• ● Yeşil: Şu an aktif (bugün geçerli)
• ● Sarı: Active ama tarih dışında (geçmiş ya da gelecek)
• ● Gri: Pasif (state=inactive)

Toplu İçe Aktarma (CSV)

Çok sayıda kuralı tek tek girmek yerine CSV dosyasından toplu yükleyin.

Erişim Yolu

Payment TR → Bankalar ve Taksitler → Toplu Kural İçe Aktarma

CSV Format

partner_email,category_name,bank_code,installment_count,interest_rate,commission_rate,priority,date_start,date_end
ahmet@firma.com,,GARANTI,12,5.0,0.0,10,,
,Premium,GARANTI,6,1.0,0.0,10,2026-05-01,2026-05-31
,Premium,,12,0.0,0.0,10,,

Kurallar

• partner_email VEYA category_name dolu olmalı (ikisi birden olamaz)
• bank_code boş bırakılırsa "tüm bankalar" anlamına gelir
• date_start / date_end opsiyonel, format: YYYY-MM-DD
• Dosya UTF-8 encoded olmalı
• İlk satır header (kolon adları) olmalı

Çakışma Çözümü & Öncelik

Aynı taksit sayısı için birden fazla kural varsa hangisinin uygulanacağını belirleyen sıralama:

1. Banka spesifik > Generic
   bank_id dolu olan kural, bank_id = boş olan kuraldan üstündür.
2. Partner > Kategori
   partner_id ile tanımlı kural, aynı müşterinin kategorisi üzerinden gelen kuraldan üstündür.
3. Priority (küçük sayı kazanır)
   İlk iki kriter eşitse priority alanına bakılır. Default değer 10'dur.

Örnek

X Holding firması "Premium" tag'ına sahip. Aşağıdaki kurallar var:

12 taksitle Garanti'den öderken Kural C kazanır — banka spesifik ve partner spesifik olduğu için.

E-Ticaret Akışı

Standart Odoo Website Shop kullanıyorsanız:

1. Müşteri ürünleri sepete ekler, /shop/payment'a gelir
2. Payment TR inline form otomatik açılır
3. Müşteri kart numarası girer → BIN tespit edilir → banka belirlenir
4. Banka'ya göre taksit listesi otomatik yüklenir
5. Müşteri özel kuralı varsa taksit oranları otomatik override edilir
6. "Şimdi Öde" → 3D Secure → Bankaya yönlendirme → Geri dönüş
7. Başarılı ise /shop/confirmation'a yönlendirme

Ödeme Linki ile Ödeme

Müşteriye e-posta veya SMS ile gönderilebilen ödeme linki.

Link Oluşturma

1. Payment TR → İşlemler → Yeni Ödeme Linki'ne tıklayın
2. Wizard'da müşteri, tutar, açıklama girin
3. Müşterinin özel taksit kuralı varsa wizard'da otomatik uyarı belirir
4. "Oluştur ve E-posta Gönder" ile linki müşteriye iletin

Link Görünümü

Link açıldığında müşteri ödeme yapabileceği sayfayı görür. Aynı inline form burada da kullanılır.

Bağımsız Ödeme Formu

Sale order olmadan açık (public) ödeme formu — bağış, aidat, ön ödeme gibi senaryolar için.

Form Oluşturma

1. Payment TR → İşlemler → Ödeme Formları'ndan yeni form ekleyin
2. Form adı, açıklama, tutar (sabit veya değişken) belirleyin
3. Üretilen URL'i müşterilerinizle paylaşın

Dashboard

Payment TR → Gösterge Paneli menüsünden ulaşılır.

Gösterilen Veriler

• Bugün/bu hafta/bu ay işlem sayısı ve tutarı
• Başarı oranı
• Banka performans listesi (top 10)
• Son işlemler

Raporlar

Payment TR → Raporlar menüsünden 4 farklı rapor mevcut:

• İşlem Raporu — pivot/graph ile tarih, banka, durum kırılımı
• Banka Performans Raporu — banka bazlı başarı oranları
• Taksit Kullanım Raporu — taksit sayılarına göre dağılım
• İade Raporu — iade işlemleri detayları

Müşteri Kural İstatistiği

Müşteri Özel Taksit Kuralları menüsünde Pivot ve Graph view'ları ile kuralların banka × taksit × faiz oran kırılımı görülebilir.

Audit Log

Bir transaction'a müşteri özel kuralı uygulandığında, ilgili payment.transaction kaydının chatter bölümüne otomatik mesaj düşer:

Müşteriye Özel Taksit Kuralı Uygulandı
Kural: X Holding - Garanti BBVA - 12 Taksit
Taksit: 12 x 262.50 = 3150.00
Faiz oranı: 5.00% (standart yerine)
Faiz tutarı: 150.00 ₺

Bu sayede her ödeme işleminde hangi kuralın uygulandığı izlenebilir, denetim raporlarında kullanılabilir.

Sıkça Sorulan Sorular

Hata Çözümleri

Kart akışı çalışmıyor

• Bankanın state = enabled olduğunu kontrol edin
• BIN ranges'ın kart numarasıyla eşleştiğini kontrol edin
• Browser console'da payment_tr log'larına bakın
• Network tab'da /payment/payment_tr/get_installments response'unu inceleyin

3D yönlendirmesi geri dönmüyor

• PHP middleware'in config.php'sinde odoo_callback_base_url'in doğru olduğunu doğrulayın
• HTTPS kullanıyorsanız sertifika geçerli olmalı
• Bankadan dönen POST'u inceleyin (PHP loglarında logs/callback.log)

Taksit listesi boş geliyor

• Banka için supports_installment = true mi?
• Bankaya ait payment.tr.installment kayıtları state = active ve sipariş tutarı min/max aralığında mı?

Faiz uygulanmadı (faizli taksit seçili olmasına rağmen)

• payment.transaction kaydını açıp payment_tr_installment_id ve payment_tr_partner_installment_id'i kontrol edin
• Sale order'da "Banka Taksit Vade Farkı" satırı yoksa _payment_tr_apply_installment_interest log'larına bakın

İletişim & Destek

Faydalı Bağlantılar

• Payment TR Dashboard
• Müşteri Özel Taksit Kuralları
• Tüm Ödeme İşlemleri