Stripe FX Quotes API vs een dedicated currency API: wat moet je in 2026 gebruiken?

Als je online betalingen accepteert, is je waarschijnlijk opgevallen dat Stripe FX Quotes API vs een dedicated currency API een van de meest gestelde architectuurvragen in fintech-engineeringkanalen is geworden. De FX-tools van Stripe zijn volwassen geworden: je kunt nu een wisselkoers tot 24 uur vastzetten, FX-kosten vooraf tonen en automatisch gelokaliseerde prijzen laten zien. De vraag ligt voor de hand: heb je nog wel een aparte wisselkoers-API nodig in je stack?

Het korte antwoord is: "het hangt ervan af, en serieuze producten gebruiken meestal beide." Het lange antwoord is dit artikel. We vergelijken de twee benaderingen op prijs, dekking, latency, nauwkeurigheid en developer experience, lopen door vijf echte engineering-scenario's en laten werkende code zien voor elke kant, zodat je een beslissing neemt die op schaal standhoudt.

TL;DR — Wanneer wint welke

Gebruik Stripe FX Quotes API wanneer de conversie verbonden is aan een door Stripe verwerkte betaling, transfer of payout, en je het tarief dat Stripe daadwerkelijk gaat rekenen, gegarandeerd wilt hebben vóór checkout.

Gebruik een dedicated wisselkoers-API zoals Finexly wanneer je koersen nodig hebt buiten de betaalstroom: prijspagina's, boekhoudrapportages, treasury-dashboards, analytics, mobiele apps, multi-currency facturatie, FX-risicomodellen of elk product dat koersen toont zonder onmiddellijk af te schrijven.

De meeste productiestacks combineren beide: een dedicated currency API voedt alles vóór en na de betaling, en Stripe FX Quotes API voedt het exacte conversiemoment in checkout. We leggen later uit waarom.

Wat de Stripe FX Quotes API werkelijk doet

De FX Quotes API is een relatief recente toevoeging aan de payments-stack van Stripe. Je kunt een gegarandeerd wisselkoers aanvragen voor een valutapaar, die quote koppelen aan een PaymentIntent, Transfer of Payout, en Stripe verbindt zich aan die koers zolang de quote niet is verlopen.

Hoe het werkt

Je vraagt Stripe een quote tussen twee valuta en een looptijd. Stripe geeft een quote-object terug met de vergrendelde koers, de vervaltijd, de FX-fee en een "premium" die toeneemt met de looptijd. Vervolgens refereer je het quote-ID bij het aanmaken van het betalingsobject. Als de quote nog geldig is bij settlement, krijg je precies de beloofde conversie.

Drie gangbare lock-duraties:

1. Een korte window van ongeveer 5 minuten, handig voor synchrone checkouts.
2. Een middel-window van 1 uur, handig voor winkelwagens, cart-recovery of quote-to-cash.
3. Een lange window van 24 uur, handig voor B2B-facturen, geplande transfers en net-terms-afrekeningen.

De prijs heeft twee delen. Eerst Stripes standaard FX-fee, rond 2% voor de meeste paren, bovenop cross-border kaartkosten. Daarnaast een aanvullende premium die met de duur groeit: een 24-uurs quote kost meer dan een 5-minutenquote omdat Stripe meer marktrisico voor je overneemt.

Waar het uitblinkt

De FX Quotes API lost één specifiek, hoogwaardig probleem extreem goed op: het haalt de onzekerheid weg uit het moment dat geld daadwerkelijk beweegt. Als ooit een klant heeft geklaagd dat de prijs in checkout niet overeenkwam met zijn kaartafschrift, ken je dat ongemak. Met een vergrendelde Stripe-quote verdwijnt die kloof. Het getal dat je toont is het getal dat wordt afgerekend.

Het is ook de enige manier om Stripes exacte FX-fee vooraf te kennen. De fee is geen schoon percentage; hij varieert per corridor, valuta en tijdstip. De FX Quotes API geeft hem als getal terug dat je kunt tonen, loggen of doorberekenen.

Waar het tekortschiet

De FX-tools van Stripe zijn strak gekoppeld aan zijn settlement-systeem. Ze zijn gebouwd rond geld dat je door Stripe gaat bewegen. Daardoor zijn ze ongeschikt voor gevallen waarin je koersen nodig hebt en geen kaart afschrijft: prijspagina's, interne rapportages, treasury-modellen, offline mobiele apps, boekhoudsystemen die bankoverboekingen reconcilieren, dashboards met FX-trends.

De dekking is ook smaller dan ze lijkt. Stripe verwerkt betalingen in 135+ valuta, maar FX Quotes zijn niet beschikbaar voor elk paar, elke regio of elke Merchant Category Code (MCC). Hoog-risico MCC's zijn volledig uitgesloten.

Wat een dedicated currency API doet

Een dedicated wisselkoers-API zoals Finexly is een gerichte dienst: hij vertelt je wat de koers tussen twee valuta is, nu en op elk moment in het verleden. Hij verplaatst geen geld. MCC's interesseren hem niet. Hij geeft betrouwbare koersdata via een eenvoudige REST.

Hoe het werkt

Je doet een HTTP-call, je krijgt een JSON met de meest recente mid-market koersen uit de Finexly API. Je kunt ook historische koersen ophalen voor elke datum jaren terug, time-series-bereiken voor grafieken of een directe conversie-endpoint die de vermenigvuldiging voor je doet.

Eén call die de huidige koers voor 170+ valuta teruggeeft:

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

De respons komt binnen 50 ms vanaf edge-locaties en is cachebaar — belangrijk voor druk bezochte prijspagina's.

Dekking en prijs

Een goede currency API dekt doorgaans 170+ valuta, inclusief majors, minors, exotics en vaak crypto. De prijs is per request en doorgaans veel goedkoper dan FX-fees van payment processors. Het free-plan van Finexly bevat 1.000 gratis requests per maand, genoeg om een kleine SaaS volledig op de free tier te draaien. Voor hogere volumes zie de prijsplannen.

Belangrijk: je betaalt voor toegang tot data, niet voor geconverteerde waarde. Als je een miljoen valutaconversies per dag toont op je marketingsite, betaal je geen percentage van een denkbeeldige $1M; je betaalt één CDN-cached API-call.

Waar het uitblinkt

Dedicated currency API's zijn het juiste gereedschap wanneer koersdata een productlaag is, geen betaallaag. Voorbeelden: marketingprijspagina die "vanaf €19" toont op basis van locale; SaaS-dashboard dat saldi in lokale valuta toont; Shopify-thema dat prijzen in 30 valuta voorvertoont vóór checkout; boekhoudsysteem dat een USD-factuur in een EUR-grootboek inboekt op de historische mid-market; fintech-app die de EUR/USD-trend van de afgelopen 5 jaar visualiseert.

Meer over deze stijl in onze gidsen multi-currency Shopify checkout en valutaconverter in React.

Waar het tekortschiet

Een dedicated currency API publiceert een mid-market referentiekoers. Dat is het juiste cijfer voor weergave, boekhouding en analyse, maar niet noodzakelijk de koers waarmee je payment processor een kaarttransactie afrekent. Heb je beslist de exacte koers nodig waarop het geld beweegt, dan is de quote van de processor de waarheid. Mid-market is de waarheid over de markt; de koers van de processor is de waarheid over de transactie.

Vergelijking naast elkaar

Vijf echte scenario's — wat te kiezen

1. Prijspagina met lokale valuta

Je runt een SaaS. De prijspagina moet "$29/maand" tonen aan US-bezoekers en "€27/maand" aan Duitsers. Dedicated currency API. Dit is weergave, geen betaling. Je wilt één sub-50ms request, urenlang cachebaar — geen per-request payment-quote met 2% ingebakken.

2. Cross-border kaartcheckout

Je klant betaalt in EUR maar jij rekent af in USD. Het bedrag op het ontvangstbewijs moet matchen met wat Stripe afschrijft. Stripe FX Quotes API. Vergrendel een 5-minutenquote bij het laden van de cart, koppel hem aan de PaymentIntent, en de klant ziet geen mismatch.

3. B2B-factuur met net-30

Je verstuurt vandaag een GBP-factuur; de klant betaalt in 25 dagen in USD. Beide. Toon het GBP-bedrag en een USD-referentie via de Finexly converter voor context. Wanneer de klant écht op betalen klikt, vraag dan op dat moment een verse Stripe-quote op. De referentiekoers bij uitgifte en de settlement-koers bij betaling zijn verschillende klussen.

4. Treasury-dashboard en FX-risicomonitoring

Het finance-team wil een Looker-achtig dashboard met cashsaldi in 7 valuta plus een 90-daagse historische grafiek van EUR/USD. Dedicated currency API. Stripe FX Quotes geven geen historie, geen time-series en zijn niet voor analytics gebouwd. Een currency API biedt de benodigde historische endpoints standaard.

5. Mobiele app met offline-modus

Je shipt een reis-app die valuta omrekent voor toeristen op luchthavens met slechte Wi-Fi. Dedicated currency API. Je kunt 170 koersen cachen in zo'n 4 KB JSON bij het opstarten en alles offline omrekenen. De FX-tools van Stripe werken niet offline, ze hangen aan een live quote. Voor meer diepte: onze exchange rate API gids voor mobiel.

Codevoorbeelden

Stripe FX Quotes API (Node.js)

import Stripe from 'stripe';
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY);

// Step 1: lock a rate good for 5 minutes
const quote = await stripe.fxQuotes.create({
  to_currencies: ['eur'],
  from_currency: 'usd',
  lock_duration: 'five_minutes',
});

const rate = quote.rates['eur'].exchange_rate;
const expiresAt = quote.lock_expires_at;

// Step 2: attach the quote to a PaymentIntent
const intent = await stripe.paymentIntents.create({
  amount: 2900,            // 29.00 USD presented to the buyer
  currency: 'eur',         // settled in EUR using the quote
  fx_quote: quote.id,
});

Je krijgt een gegarandeerde koers, kunt het EUR-bedrag tonen vóór betaling, en de settlement matcht exact. De trade-off: je betaalt Stripes FX-fee plus een kleine premium voor het lock-window.

Finexly Currency API (Node.js)

const API_KEY = process.env.FINEXLY_API_KEY;

async function getRates() {
  const res = await fetch(
    'https://api.finexly.com/v1/latest?base=USD&symbols=EUR,GBP,JPY',
    { headers: { Authorization: `Bearer ${API_KEY}` } }
  );
  const data = await res.json();
  return data.rates;
}

// Display localized pricing
const rates = await getRates();
const priceInEur = (29 * rates.EUR).toFixed(2);
console.log(`Price for German visitor: €${priceInEur}`);

Dit is de koers die je toont, logt of voor analytics gebruikt. Je commit niet aan een transactie; je leest de markt. Cache het antwoord een uur en één call bedient duizenden pageviews. Meer voorbeelden per taal in onze Node.js-gids of Python-tutorial.

Verborgen kosten om op te letten

Bij het vergelijken niet stoppen bij de koppen. Diverse kosten zitten onder water.

Verrassingen aan Stripe-kant. De 2% FX is een gemiddelde; sommige corridors zijn hoger. Adaptive Pricing kan 2–4% extra rekenen, voor de klant onzichtbaar maar prijsverhogend. Cross-border kaartkosten stapelen op de FX. Verwerk je $100K/maand cross-border, dan is zelfs 0,5% gat $6K/jaar.

Valkuilen van currency API's. Free-plans hebben vaak strakke rate-limits — plan caching vanaf dag 1. Sommige aanbieders updaten dagelijks; heb je intraday-precisie nodig, controleer dan de frequentie. Lees onze deep-dive over caching en errorhandling voor je live gaat.

De kosten van geen quote gebruiken. Toon je een prijs op de koers van gisteren en rekent Stripe af op die van vandaag, dan is het verschil voor jouw rekening. Bij 1% beweging klein per transactie maar maandgemiddeld telt het op. Vergrendel in checkout of accepteer de variantie met een buffer in je prijs.

Hoe combineer je beide voor het beste resultaat

De sterkste productie-architectuur die we bij Finexly zien:

Een dedicated currency API voedt alles buiten het betaalmoment: prijspagina's, dashboards, boekhouding, mobiele apps, search, analytics, FX-risico-rapportages. Cache agressief (1 uur TTL is meestal prima). Eén API-key, voorspelbare kosten, sub-50ms responses.

De Stripe FX Quotes API voedt alles binnen het betaalmoment: vergrendelde koersen in checkout, exacte cijfers op ontvangstbewijzen, settlement-conforme boekingen. Geen verrassingen voor de klant.

Reconciliatie sluit de loop. Log na elke Stripe settlement zowel de Stripe settlement-koers als de bijbehorende mid-market van de currency API. Het verschil is je werkelijke FX-kosten, en dit door de tijd volgen is een van de meest hefboomgevende dingen die een fintech finance-team kan doen. Verdiep je in de gidsen valuta-hedging en valuta-risicobeheer.

Voor een directe vergelijking met andere dedicated providers: onze ExchangeRate-API vs CurrencyLayer vs Finexly vergelijking ontleedt ze op dezelfde dimensies.

Veelgestelde vragen

Is de Stripe FX Quotes API gratis?

De API zelf rekent niet per call, maar de conversies dragen Stripes standaard FX-fee (~2% voor de meeste paren) plus een kleine premium voor lange locks. Geen aparte "abonnement"; de prijs zit in de betaling.

Kan ik een currency API gebruiken om Stripe-betalingen op een eigen koers af te rekenen?

Nee. Stripe rekent altijd af op zijn eigen koers; je kunt geen externe koers in Stripes settlement-engine injecteren. Wat wél kan: een eigen koers tonen aan de klant (uit jouw API + jouw marge) en met een Stripe-quote de echte settlement vergrendelen. Mis je een haar, dan is het gat voor jou.

Hoeveel sneller is een dedicated currency API?

Een typische edge-call van een currency API komt binnen 50 ms terug. Een Stripe FX Quote round-trip is meestal 150–400 ms omdat het een live, ondertekende call tegen de payments-infra is. Op een marketingsite met honderden valutalabels per pagina is dat het verschil tussen instant render en zichtbare vertraging.

Wat als een Stripe-quote verloopt voor je hem gebruikt?

De quote wordt ongeldig en je moet een nieuwe opvragen. In synchrone checkout zelden. In asynchroon werk (B2B-facturen, geplande transfers) kies een langere lock vooraf of bereid een refresh + herbevestiging met de klant voor.

Kan ik Stripes FX-fee helemaal vermijden?

Soms. Houd je saldi aan in de valuta van de klant en reken je in die valuta af, dan is geen FX nodig. Multi-currency Stripe-accounts en een treasurystrategie over meerdere PSP's elimineren grote delen. Een dedicated currency API gebruik je om te modelleren of die strategie de moeite waard is.

Begin

Klaar om realtime wisselkoersen aan je project toe te voegen? Pak je gratis Finexly API-key — geen creditcard. Start met 1.000 gratis requests per maand, sub-50ms responses en 170+ valuta out-of-the-box, en schaal mee als je groeit.