Ana içeriğe geç

Version Docs Updated

Amaç

Ödeme süreçleri (WooCommerce, Iyzico, Stripe vb.) ve finansal defter (Ledger) arasındaki uyumsuzlukları teşhis etmek ve gidermek için teknik bir rehberdir.

💳 Ödeme ve Finansal Sorun Giderme

Ödeme hataları genellikle API bağlantıları, statü eşleşmeleri (Mapping) veya veritabanı kilitleri kaynaklıdır.

🛑 1. Yaygın Hata Kodları ve Çözümleri​

HTTP 400 / 401 (Hatalı İstek / Yetkisiz Erişim)​

  • Neden: API anahtarları (Public/Private Key) yanlış girilmiş veya Test/Live modu uyumsuz.
  • Çözüm: Rentiva > Ödeme Ayarları sekmesinden anahtarların doğruluğunu ve "Çalışma Modunu" konfirme edin.

HTTP 403 (Erişim Engellendi)​

  • Neden: Ödeme sağlayıcısının IP adresleri sunucu güvenlik duvarı (WAF/Cloudflare) tarafından engelleniyor olabilir.
  • Çözüm: Ödeme sağlayıcısının (Örn: Iyzico, Stripe) IP aralıklarını beyaz listeye (Whitelist) ekleyin.

HTTP 500 (Sunucu Hatası)​

  • Neden: Callback işlemi sırasında bir PHP hatası veya veritabanı çakışması.
  • Çözüm: wp-content/debug.log dosyasını inceleyin ve WooCommerceBridge::handle_webhook() metodundaki hataları ayıklayın.

🔄 2. Statü Eşleşme (Status Mapping) Sorunları​

Ödeme "Tamamlandı" ama rezervasyon hala "Beklemede"?​

  • Kontrol: WooCommerce sipariş statüsünün processing veya completed olduğundan emin olun.
  • Teknik Detay: Rentiva, WooCommerce status hook'larını (woocommerce_order_status_changed) dinler. Eğer otomatik tetiklenme olmuyorsa, eklenti çakışması olabilir.
  • Çözüm: Manuel sipariş güncellemesi yaparak Rentiva statüsünün senkronize olup olmadığını test edin.

📖 3. Ledger (Defter) Tutarsızlıkları​

"Double-Spending" (Mükerrer Ödeme) Denemeleri​

  • Durum: Bir ödeme talebi (Payout) onaylanmış görünüyor ama bakiye düşmemiş.
  • Neden: AtomicPayoutService transaction kilidine takılmış olabilir.
  • Çözüm: mhm_rentiva_ledger tablosunda ilgili UUID ile bir kayıt olup olmadığını SQL üzerinden doğrulayın.

Commission Credit Oluşmuyor?​

  • Neden: Komisyon motoru (CommissionEngine), rezervasyonu sadece completed (Seyahat Bitti) statüsünde işler.
  • Çözüm: Rezervasyonun gerçekten sona erdiğini ve statüsünün completed olduğunu konfirme edin.

🛠️ 4. API Bağlantı Testi (Idempotency)​

Tüm API çağrılarında idempotency anahtarı kullanılır:

  • Teşhis: Aynı ödeme isteğinin birden fazla kez gitmesi engellenmiştir.
  • Çözüm: Eğer bir callback hatası alıyorsanız, ödeme sağlayıcısından gelen transaction_id değerini AdvancedLogger üzerinden aratın ve mükerrer kayıt olup olmadığını kontrol edin.

Denetim Listesi​

  1. API anahtarlarının doğruluğu (Test vs Live).
  2. Güvenlik duvarı (WAF) blokları.
  3. Webhook/Callback URL'inin doğruluğu.
  4. WooCommerce statü senkronizasyonu.

Değişiklik Günlüğü​

TarihSürümNot
19.03.20264.21.2API Hata Kodları, Status Mapping ve Ledger tutarlılık detayları eklendi.