Akıllı Yönlendirme — Genel Bakış

• BIN aralığı
• Tutar
• Taksit sayısı
• Kart birliği (Visa/MC/Troy)
• Kart tipi (kredi/banka)
• 3DS durumu
• Banka sağlık durumu (latency, hata oranı)
• Komisyon oranları
• Trafik dağıtım hedefi

​

Neden akıllı yönlendirme?

​

Yapı

​

Yönlendirme adımları

1. Kuralları sırayla değerlendir — istek koşullara karşı kontrol edilir.
2. Skor hesapla — eşleşen her kural için bir bileşik skor üretilir (banka sağlığı, komisyon, ağırlık).
3. En yüksek skorlu konnektörü seç.
4. Smart Retry hazır olsun — birinci konnektör başarısız olursa fallback için sıralanmış alternatifler.

​

Kural yapısı

​

Banka sağlığı

• Son 5 dakikadaki başarı oranı
• Ortalama yanıt süresi
• 5xx hata yoğunluğu

​

Smart Retry

​

Kuralları yönetme

• /routing-rules — gelişmiş bileşik skor motoru (BIN + tutar + taksit + sağlık + ağırlık)
• /simple-routing-rules — basit “şu koşulda şu konnektör” kuralları (yeni başlayanlar için)

GET    /api/v1/routing-rules                       # Liste (sayfalı)
GET    /api/v1/routing-rules/{id}                  # Tek kural detayı
POST   /api/v1/routing-rules                       # Yeni kural
PUT    /api/v1/routing-rules/{id}                  # Güncelleme
DELETE /api/v1/routing-rules/{id}                  # Silme
POST   /api/v1/routing-rules/bulk-delete           # Toplu silme
POST   /api/v1/routing-rules/{id}/activate
POST   /api/v1/routing-rules/{id}/deactivate
PATCH  /api/v1/routing-rules/{id}/score            # Skor güncelleme

​

Simülasyon

• Konsoldaki Routing Simulator ekranı (görsel arayüz)
• Public /resolve endpoint’i — bir koşul setine göre eşleşen kuralları döndürür:

curl -X POST https://vpos.payven.com.tr/api/v1/routing-rules/resolve \
  -H "Authorization: Bearer $PAYVEN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "card_bin":     "454671",
    "amount":       15000,
    "installment":  3,
    "card_brand":   "bonus",
    "card_type":    "credit",
    "currency":     "TRY"
  }'

​

Settings (varsayılan davranış)

GET /api/v1/routing-rules/settings
PUT /api/v1/routing-rules/settings