ISO 4217 Valutacodes: De Complete Gids voor Ontwikkelaars

Als u ooit een betaalsysteem heeft gebouwd, een wisselkoers-API heeft geïntegreerd of prijzen in meerdere valuta's heeft weergegeven, bent u al ISO 4217 valutacodes tegengekomen — of u het nu wist of niet. Deze drieledige codes zoals USD, EUR, JPY en GBP zijn de universele taal van geld in softwareontwikkeling. Begrijpen hoe ze werken, waar ze vandaan komen en hoe ze correct te gebruiken is essentieel voor elke ontwikkelaar die financiële applicaties bouwt.

Deze gids behandelt alles wat u moet weten: de structuur van valutacodes, een referentielijst van de meest gebruikte valuta's ter wereld, het omgaan met kleineenheden en speciale codes, en hoe u ze integreert met de Finexly API-documentatie voor realtime wisselkoersen.

Wat is ISO 4217?

ISO 4217 is een internationale standaard, gepubliceerd door de Internationale Organisatie voor Standaardisatie (ISO), die codes definieert voor het weergeven van wereldvaluta's. Voor het eerst geïntroduceerd in 1978, wordt het nu universeel gebruikt in banksystemen, financiële software, e-commerceplatforms, betalingsverwerkers en wisselkoers-API's.

De standaard dient drie hoofddoelen:

• Ambiguïteit elimineren — "Dollar" kan de Amerikaanse, Canadese, Australische of tientallen andere dollars betekenen. USD, CAD, AUD zijn ondubbelzinnig.
• Geautomatiseerde verwerking mogelijk maken — Zowel alfabetische als numerieke codes stellen systemen met verschillende tekensetondersteuning in staat om valutagevens betrouwbaar te verwerken.
• Internationale interoperabiliteit ondersteunen — Elk conform systeem kan financiële gegevens uitwisselen zonder aangepaste toewijzingen.

De Codestructuur Begrijpen

Alfabetische Codes (Alpha-3)

Elke ISO 4217 alfabetische code bestaat precies uit drie hoofdletters ASCII:

• Eerste twee letters — Afgeleid van de ISO 3166-1 alpha-2 landcode (bijv. US voor de VS, JP voor Japan, GB voor Groot-Brittannië, NL voor Nederland)
• Derde letter — Gewoonlijk de eerste letter van de valutanaam (bijv. D voor Dollar, Y voor Yen, P voor Pound)

USD = VS (US) + Dollar (D). JPY = Japan (JP) + Yen (Y). GBP = Groot-Brittannië (GB) + Pond (P).

Numerieke Codes

Elke valuta heeft ook een driecijferige numerieke code (bijv. 840 voor USD, 978 voor EUR, 826 voor GBP). Deze numerieke codes zijn bijzonder nuttig in systemen die geen Latijnse tekens verwerken.

Kleine Eenheden (Decimalen)

ISO 4217 specificeert ook het aantal decimalen (kleine eenheden) voor elke valuta:

Referentietabel van Belangrijkste Wereldvaluta's

Amerika

Europa

Azië-Pacific

Valutacodes Gebruiken met de Finexly API

De Finexly API ondersteunt meer dan 170 ISO 4217 valutacodes. Zo haalt u realtime wisselkoersen op:

cURL

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

JavaScript

const BASE_CURRENCY = 'USD';
const TARGET_CURRENCIES = ['EUR', 'GBP', 'JPY', 'CHF', '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 UW_API_SLEUTEL' }
  });

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

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

Python

import requests

API_KEY = "UW_API_SLEUTEL"
BASE = "USD"
TARGETS = ["EUR", "GBP", "JPY", "CHF", "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}")

Valuta's Opmaken per Locale

function formatCurrency(amount, currencyCode, locale = 'nl-NL') {
  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, 'EUR', 'nl-NL')); // € 1.234,56
console.log(formatCurrency(1234.56, 'GBP', 'en-GB')); // £1,234.56
console.log(formatCurrency(1500, 'JPY', 'ja-JP'));     // ¥ 1.500

Veelgemaakte Fouten door Ontwikkelaars

Fout 1: Valuta opslaan als getal met drijvende komma

# ❌ FOUT — fouten met drijvende komma veroorzaken problemen
total = 19.99 * 1.20  # 23.988000000000003

# ✅ JUIST — gebruik integers in kleine eenheden
price_cents = 1999  # €19,99 opgeslagen in centen

Fout 2: Aannemen dat alle valuta's 2 decimalen hebben

// ❌ FOUT
formatJPY(1500)  // "1500.00 JPY" — ONJUIST!

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

Veelgestelde Vragen

Wat is het verschil tussen een valutacode en een valutasymbool? Een valutacode is een gestandaardiseerde drielettrige identificator (bijv. USD) gedefinieerd door ISO 4217, terwijl een valutasymbool een typografische afkorting is (bijv. $, €, £). Symbolen variëren per locale, maar valutacodes zijn altijd ondubbelzinnig.

Hoeveel ISO 4217 valutacodes zijn er? Vanaf 2026 zijn er ongeveer 180 actieve valutacodes. Finexly ondersteunt er meer dan 170 voor realtime wisselkoersquery's.

Kan ik valutacodes gebruiken met het gratis Finexly-abonnement? Ja — het gratis abonnement geeft toegang tot alle ondersteunde ISO 4217 valutacodes met tot 1.000 API-verzoeken per maand.

Waarom heeft de Japanse Yen (JPY) geen decimalen? De Yen werd anders gedecimaliseerd dan de meeste valuta's. Hoewel er technisch een subeenheid bestaat genaamd "sen" (1/100 van een Yen), worden sen in de praktijk niet meer gebruikt.

Welke valutacode moet ik gebruiken voor de Euro in alle Eurozoneleden? Gebruik altijd EUR — het is dezelfde valutacode of de transactie nu in Duitsland, Frankrijk, Spanje, Nederland of een ander Eurozonelidstaat plaatsvindt.

Klaar om realtime wisselkoersen te integreren in uw project? Ontvang uw gratis Finexly API-sleutel — geen creditcard vereist. Begin met 1.000 gratis verzoeken per maand en open toegang tot realtime koersen voor meer dan 170 ISO 4217-valuta's. Upgrade naarmate u groeit.