Skip to main content
MCC (Merchant Category Code), kart endüstrisinde merchant’ı sektörüne göre sınıflayan 4 haneli ISO standardıdır. Mutabakat, fraud kuralları, raporlama ve banka komisyonu hesaplamasında kullanılır.

​
Endpoint

GET /api/v1/lookups/mcc-codes
Bearer access token gerektirir. 
curl "https://identity.payven.com.tr/api/v1/lookups/mcc-codes?search_term=restoran&page=1&page_size=20" \
  -H "Authorization: Bearer $PAYVEN_TOKEN"
Query parametresiAçıklama
search_termKod veya açıklamada “içerir” araması
categoryÜst kategori filtresi (örn. food, retail, travel)
page, page_sizeSayfalama (default 1, 50; max 200)

​
Yanıt

200 OK — sayfalı liste: 
{
  "items": [
    {
      "code":            "5812",
      "description":     "Yiyecek Servisleri ve Restoranlar",
      "description_en":  "Eating Places, Restaurants",
      "category":        "food"
    },
    {
      "code":            "5814",
      "description":     "Fast Food Restoranlar",
      "description_en":  "Fast Food Restaurants",
      "category":        "food"
    }
  ],
  "page":              1,
  "total_pages":       1,
  "total_count":       2,
  "has_previous_page": false,
  "has_next_page":     false
}

​
Kullanım

  • Onboarding — yeni merchant kaydederken sektör seçimi
  • Fraud kuralları — belirli MCC’ler için ek kontrol (örn. 7273 = arkadaş bulma servisleri için yüksek risk skoru)
  • Banka komisyonu — bazı bankalar MCC bazlı komisyon hesaplar
  • Raporlama — işlemleri sektöre göre gruplama

​
Yaygın kategoriler

KategoriÖrnek MCCAçıklama
retail5311, 5651Mağazalar, giyim
food5812, 5814, 5411Restoran, fast food, market
travel4511, 7011, 4789Havayolu, otel, ulaşım
online5969, 7372E-ticaret, yazılım
services7311, 8011, 8021Reklam, sağlık
entertainment7832, 7922Sinema, tiyatro
utilities4900, 4814Elektrik / gaz / su, telekom
Tam liste 800+ koddan oluşur (ISO 18245 standardı). Kataloğu uygulamanızın başlangıcında bir kez çekip cache’lemeniz önerilir — yıl içinde nadiren güncellenir.