ISO 4217 Para Birimi Kodları: Geliştiriciler İçin Eksiksiz Kılavuz

Hiç bir ödeme sistemi kurduysanız, döviz kuru API'si entegre ettiyseniz veya birden fazla para biriminde fiyatlar görüntülediyseniz, farkında olsanız da olmasanız da ISO 4217 para birimi kodlarıyla zaten karşılaştınız. USD, EUR, JPY ve GBP gibi üç harfli kodlar, yazılım geliştirmede paranın evrensel dilidir. Bu kodların nasıl çalıştığını, nereden geldiğini ve nasıl doğru kullanılacağını anlamak, finansal uygulamalar geliştiren her geliştirici için gereklidir.

Bu kılavuz, bilmeniz gereken her şeyi kapsar: para birimi kodlarının yapısı, dünyanın en çok kullanılan para birimlerinin referans listesi, küçük birimler ve özel kodlarla nasıl çalışılacağı ve gerçek zamanlı döviz kurları için Finexly API belgeleri ile nasıl entegre edileceği.

ISO 4217 Nedir?

ISO 4217, Uluslararası Standartlaştırma Örgütü (ISO) tarafından yayımlanan ve dünya para birimlerini temsil etmek için kodlar tanımlayan uluslararası bir standarttır. İlk kez 1978'de tanıtılan bu standart, artık bankacılık sistemlerinde, finansal yazılımlarda, e-ticaret platformlarında, ödeme işlemcilerinde ve döviz kuru API'lerinde evrensel olarak kullanılmaktadır.

Standart üç temel amaca hizmet eder:

• Belirsizliği ortadan kaldırma — "Dolar" ABD doları, Kanada doları, Avustralya doları veya düzinelerce başka para birimini ifade edebilir. USD, CAD, AUD tartışmasızdır.
• Otomatik işlemeyi sağlama — Hem alfabetik hem de sayısal kodlar, farklı karakter seti desteğine sahip sistemlerin para birimi verilerini güvenilir şekilde işlemesini sağlar.
• Uluslararası birlikte çalışabilirliği destekleme — Uyumlu herhangi bir sistem, özel eşlemeler olmadan finansal verileri değiş tokuş edebilir.

Kod Yapısını Anlama

Alfabetik Kodlar (Alpha-3)

Her ISO 4217 alfabetik kodu tam olarak üç büyük harf ASCII karakterden oluşur:

• İlk iki harf — ISO 3166-1 alpha-2 ülke kodundan türetilmiştir (örn. ABD için US, Japonya için JP, Büyük Britanya için GB, Türkiye için TR)
• Üçüncü harf — Genellikle para biriminin adının ilk harfi (örn. Dolar için D, Yen için Y, Pound için P)

USD = ABD (US) + Dolar (D). JPY = Japonya (JP) + Yen (Y). TRY = Türkiye (TR) + Lira (Y). GBP = Büyük Britanya (GB) + Pound (P).

Sayısal Kodlar

Her para biriminin aynı zamanda üç haneli sayısal kodu da bulunur (örn. USD için 840, EUR için 978, GBP için 826, TRY için 949). Bu sayısal kodlar özellikle Latin karakterleri desteklemeyen sistemlerde kullanışlıdır.

Küçük Birimler (Ondalık Basamaklar)

ISO 4217, her para birimi için ondalık basamak sayısını (küçük birimler) da belirler:

Başlıca Dünya Para Birimleri Referans Tablosu

Amerika Kıtası

Avrupa

Asya-Pasifik

Finexly API ile Para Birimi Kodlarını Kullanma

Finexly API, 170'ten fazla ISO 4217 para birimi kodunu destekler. Gerçek zamanlı döviz kurlarını şu şekilde alabilirsiniz:

cURL

curl "https://finexly.com/api/latest?base=USD&symbols=EUR,GBP,TRY,JPY,AUD" \
  -H "Authorization: Bearer API_ANAHTARINIZ"

JavaScript

const BASE_CURRENCY = 'USD';
const TARGET_CURRENCIES = ['EUR', 'GBP', 'TRY', 'JPY', 'AUD'];

async function getExchangeRates() {
  const symbols = TARGET_CURRENCIES.join(',');
  const url = `https://finexly.com/api/latest?base=${BASE_CURRENCY}&symbols=${symbols}`;

  const response = await fetch(url, {
    headers: { 'Authorization': 'Bearer API_ANAHTARINIZ' }
  });

  const data = await response.json();
  return data.rates;
}

getExchangeRates().then(rates => {
  console.log(`1 USD = ${rates.EUR} EUR`);
  console.log(`1 USD = ${rates.TRY} TRY`);
});

Python

import requests

API_KEY = "API_ANAHTARINIZ"
BASE = "USD"
TARGETS = ["EUR", "GBP", "TRY", "JPY", "AUD"]

response = requests.get(
    "https://finexly.com/api/latest",
    params={"base": BASE, "symbols": ",".join(TARGETS)},
    headers={"Authorization": f"Bearer {API_KEY}"}
)

data = response.json()
for code, rate in data["rates"].items():
    print(f"1 {BASE} = {rate} {code}")

Yerel Ayara Göre Para Birimi Biçimlendirmesi

function formatCurrency(amount, currencyCode, locale = 'tr-TR') {
  return new Intl.NumberFormat(locale, {
    style: 'currency',
    currency: currencyCode,
  }).format(amount);
}

console.log(formatCurrency(1234.56, 'USD', 'en-US')); // $1,234.56
console.log(formatCurrency(1234.56, 'TRY', 'tr-TR')); // ₺1.234,56
console.log(formatCurrency(1234.56, 'EUR', 'de-DE')); // 1.234,56 €
console.log(formatCurrency(1500, 'JPY', 'ja-JP'));     // ¥1.500

Geliştiricilerin Sık Yaptığı Hatalar

Hata 1: Para birimlerini kayan noktalı sayı olarak saklamak

# ❌ YANLIŞ — kayan nokta hataları sorun yaratacak
total = 19.99 * 1.20  # 23.988000000000003

# ✅ DOĞRU — küçük birim tamsayıları kullanın
price_cents = 1999  # $19.99 kuruş olarak saklandı

Hata 2: Tüm para birimlerinin 2 ondalık basamağa sahip olduğunu varsaymak

// ❌ YANLIŞ
formatJPY(1500)  // "1500.00 JPY" — HATALI!

// ✅ DOĞRU
new Intl.NumberFormat('ja-JP', { style: 'currency', currency: 'JPY' }).format(1500); // ¥1.500

Sıkça Sorulan Sorular

Para birimi kodu ile para birimi sembolü arasındaki fark nedir? Para birimi kodu, ISO 4217 tarafından tanımlanan standartlaştırılmış üç harfli bir tanımlayıcıdır (örn. USD), para birimi sembolü ise tipografik bir kısaltmadır (örn. $, €, £). Semboller yerel ayara göre değişir, ancak para birimi kodları her zaman kesindir.

Kaç tane ISO 4217 para birimi kodu var? 2026 itibarıyla yaklaşık 180 aktif para birimi kodu bulunmaktadır. Finexly, gerçek zamanlı döviz kuru sorguları için bunların 170'inden fazlasını destekler.

Finexly'nin ücretsiz planıyla para birimi kodlarını kullanabilir miyim? Evet — ücretsiz plan, aylık 1.000 API isteğine kadar desteklenen tüm ISO 4217 para birimi kodlarına erişim sağlar.

Neden Japon Yeni (JPY) ondalık basamağa sahip değil? Yen, çoğu para biriminden farklı bir şekilde ondalıklaştırıldı. Teknik olarak "sen" adlı bir alt birim (Yen'in 1/100'ü) olsa da, bunlar artık pratikte kullanılmamaktadır.

Euro Bölgesinin tüm ülkeleri için hangi para birimi kodunu kullanmalıyım? Her zaman EUR kullanın — Almanya, Fransa, İspanya, İtalya veya diğer Euro Bölgesi ülkelerinde olsun, işlem için aynı koddur.

Projenize gerçek zamanlı döviz kurlarını entegre etmeye hazır mısınız? Ücretsiz Finexly API anahtarınızı alın — kredi kartı gerekmez. Aylık 1.000 ücretsiz istekle başlayın ve 170'ten fazla ISO 4217 para birimi için gerçek zamanlı kurları alın. Büyüdükçe planınızı yükseltin.