Ana içeriğe geç

Version Docs Updated

Amaç

Bu sayfa, Transfer modülünün asenkron çalışma yapısını, sepete ekleme süreçlerini ve dış servislerle olan webhook haberleşme trafiğini açıklar.

🛣️ Transfer Servisleri ve Webhook Akışları

Transfer modülü, kiralama modülünden farklı olarak noktadan noktaya (Point-to-Point) fiyatlandırma ve özel rota hesaplamaları içerir. Bu süreçler AJAX ve REST API üzerinden hibrit bir şekilde yönetilir.

🛒 1. Transfer Rezervasyon Akışı (Frontend)​

Müşteri tarafındaki etkileşimler yüksek performans için AJAX tabanlı yürütülür:

  • Aksiyon: rentiva_transfer_add_to_cart
  • Güvenlik: rentiva_transfer_nonce kontrolü zorunludur.
  • Veri Modeli: booking_type=transfer etiketi ile WooCommerce sepetine eklenir.
  • İş Akışı: Seçilen araç tipi, kişi sayısı ve rota bilgileri TransferPricingEngine tarafından doğrulanarak sepete yansıtılır.

📡 2. Webhook ve Callback Mekanizması​

Dış ödeme sağlayıcıları ve transfer partnerleri ile olan iletişim REST uç noktaları üzerinden sağlanır.

Payout ve Rezervasyon Callback​

  • Route: /mhm-rentiva/v1/payouts/{id}/callback
  • Doğrulama: HMAC-SHA256 tabanlı imza kontrolü.
  • İşleyiş: Ödeme servisinden gelen "Başarılı" sinyali sonrası TransferService rezervasyonu onaylar ve ilgili taraflara (Müşteri/Tedarikçi) bildirim gönderir.

🏥 3. Sistem Sağlık Denetimi (Health Endpoint)​

Sistemin dışarıdan izlenebilirliğini (Monitoring) sağlar.

  • URL: /wp-json/mhm-rentiva/v1/health
  • Kullanım Alanları: Uptime izleme, Smoke Test ve CI/CD sonrası canlılık kontrolü.
  • Dönen Veri: Veritabanı tablolarının durumu, /tmp dizini yazma izinleri ve PHP sürüm uyumluluğu.

🛡️ 4. Güvenlik ve Hız Sınırları (Rate Limiting)​

  • Genel Sınır: Transfer arama uç noktaları için dakikada 30 istek.
  • Callback Sınırı: IP bazlı değil, servis sağlayıcı kimliği (PSP Identity) bazlı özel limitler uygulanır.
  • Idempotency: Aynı bildirim ID'sine sahip tekrarlı istekler işlem görmez, ancak 200 OK dönülür.

Bölüm Sonu Özeti​

  • Transfer modülü, AJAX (Frontend) ve REST (Backend/External) katmanlarını bir arada kullanır.
  • Tüm finansal etkileşimler imza tabanlı (HMAC) doğrulamaya tabidir.
  • Health endpointi ile sistemin operasyonel durumu anlık takip edilebilir.

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

TarihSürümNot
19.03.20264.21.2TransferPricingEngine entegrasyonu, Health endpoint detayları ve HMAC doğrulama akışı eklendi.