Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt

Use this file to discover all available pages before exploring further.

İl ve ilçe lookup’ları, merchant onboarding ve adres formlarında dropdown doldurmak için kullanılır.

Şehirler

GET /api/v1/lookups/cities
{
  "isSuccess": true,
  "data": {
    "items": [
      { "id": "...", "code": "34", "name": "İstanbul" },
      { "id": "...", "code": "06", "name": "Ankara" },
      { "id": "...", "code": "35", "name": "İzmir" }
    ]
  }
}
AlanAçıklama
codePlaka kodu (34, 06, …)
nameTürkçe isim

İlçeler

GET /api/v1/lookups/districts?cityId={cityId}
İlçeleri şehir bazında çekersiniz. Tüm ilçeleri tek seferde almak yerine seçilen şehre göre lazy-load önerilir.
{
  "isSuccess": true,
  "data": {
    "items": [
      { "id": "...", "name": "Kadıköy", "cityId": "..." },
      { "id": "...", "name": "Beşiktaş", "cityId": "..." }
    ]
  }
}

Caching

Bu liste çok nadir değişir (yeni ilçe atanması nadirdir). 7 günlük cache uygulayabilirsiniz.