Stripe FX Quotes API ile özel döviz API: 2026'da hangisini kullanmalı?

Online ödeme alıyorsanız, Stripe FX Quotes API ile özel bir döviz API karşılaştırmasının fintech mühendislik kanallarında en sık karşılaşılan mimari sorulardan biri haline geldiğini fark etmişsinizdir. Stripe'ın FX araçları olgunlaştı: artık bir kuru 24 saate kadar kilitleyebilir, FX ücretlerini önceden gösterebilir ve yerelleştirilmiş fiyatları otomatik olarak sergileyebilirsiniz. Doğal soru şu: yine de stack'inizde ayrı bir kur API'sine ihtiyacınız var mı?

Kısa cevap: "duruma göre değişir, ciddi ürünlerin çoğu sonunda her ikisini birden kullanır." Uzun cevap bu yazı. İki yaklaşımı fiyat, kapsam, gecikme, doğruluk ve geliştirici deneyimi açısından karşılaştıracak, beş gerçek mühendislik senaryosunu inceleyecek ve her iki taraf için çalışan kod göstereceğiz; ölçeğe dayanacak bir karar verebilesiniz diye.

TL;DR — Hangisi ne zaman kazanır

Dönüşüm Stripe üzerinden işlenen bir ödeme, transfer veya payout'a bağlıysa ve Stripe'ın gerçekte alacağı kurun checkout'tan önce garanti altına alınmasını istiyorsanız Stripe FX Quotes API kullanın.

Ödeme akışı dışında kurlara ihtiyacınız varsa Finexly gibi özel bir döviz API: fiyat sayfaları, muhasebe raporları, hazine dashboard'ları, analitik, mobil uygulamalar, çoklu para birimi faturalama, FX risk modelleri veya hemen tahsilat yapmadan kur gösteren her ürün.

Üretim stack'lerinin çoğu ikisini birleştirir: özel döviz API ödeme öncesi ve sonrası her şeyi besler, Stripe FX Quotes API ise checkout'taki tam dönüşüm anını besler. Nedenini birazdan anlatacağız.

Stripe FX Quotes API gerçekte ne yapar

Stripe'ın FX Quotes API'si, ödeme stack'ine nispeten yeni eklenen bir özellik. Bir döviz çifti için garantili bir kur talep edebilir, bu quote'u bir PaymentIntent, Transfer veya Payout'a iliştirebilirsiniz; quote süresi dolmadığı sürece Stripe bu kurla mutabakat yapmayı taahhüt eder.

Nasıl çalışır

Stripe'dan iki para birimi ve bir süre için bir quote istersiniz. Stripe; kilitli kuru, son geçerlilik zamanını, FX ücretini ve süreye göre artan bir "premium"u içeren bir quote nesnesi döner. Sonra ödeme nesnesini oluştururken bu quote ID'sini referans verirsiniz. Mutabakat anında quote hâlâ geçerliyse, vaat edilen dönüşümü tam olarak alırsınız.

Üç yaygın kilit süresi:

1. Yaklaşık 5 dakikalık kısa pencere, eşzamanlı checkout için uygun.
2. Yaklaşık 1 saatlik orta pencere, sepetler, sepet kurtarma veya quote-to-cash için uygun.
3. Yaklaşık 24 saatlik uzun pencere, B2B faturalar, planlı transferler ve net-vadeli mutabakatlar için uygun.

Fiyatın iki bileşeni var. Birincisi, Stripe'ın standart FX ücreti, çoğu çift için yaklaşık %2 ve sınır ötesi kart işlem maliyetinin üzerine eklenir. İkincisi, süreye göre artan ek premium: 24 saatlik quote, 5 dakikalıktan daha pahalıdır çünkü Stripe sizin yerinize daha fazla piyasa riski üstlenir.

Güçlü olduğu yer

FX Quotes API, çok değerli ve net bir sorunu son derece iyi çözer: paranın gerçekten hareket ettiği anın belirsizliğini ortadan kaldırır. Bir müşteri size daha önce checkout fiyatının kart ekstresiyle uyuşmadığını şikâyet ettiyse, o konuşmanın acısını bilirsiniz. Kilitli bir Stripe quote'uyla bu fark kaybolur. Gösterdiğiniz sayı, mutabakatı yapılan sayıdır.

Bu aynı zamanda Stripe'ın tam FX ücretini önceden öğrenmenin tek yoludur. Ücret temiz bir yüzde değildir; koridora, para birimine ve günün saatine göre değişir. FX Quotes API, bunu gösterilebilir, loglanabilir veya alıcıya yansıtılabilir bir sayı olarak sunar.

Zayıf olduğu yer

Stripe'ın FX araçları, mutabakat sistemine sıkı sıkıya bağlıdır. Stripe üzerinden taşıyacağınız para etrafında kurulmuştur. Bu da kurlara ihtiyaç duyduğunuz ama kart çekmediğiniz durumlar için kötüdür: fiyat sayfaları, dahili raporlar, hazine modelleri, çevrimdışı çalışan mobil uygulamalar, banka transferlerini eşleştiren muhasebe sistemleri, FX trendlerini görselleştiren dashboard'lar.

Kapsam da göründüğünden dardır. Stripe 135'ten fazla para biriminde ödeme işler, ancak FX Quotes her çift, her bölge ve her Merchant Category Code (MCC) için kullanılabilir değildir. Yüksek riskli MCC'ler tamamen dışarıdadır.

Özel döviz API ne yapar

Finexly gibi bir özel döviz kuru API'si odaklı bir hizmettir: iki para birimi arasındaki kurun şu an ve geçmişin herhangi bir anında ne olduğunu söyler. Para taşımaz. MCC'leri umursamaz. Sadece basit bir REST arayüzü üzerinden güvenilir kur verisi sağlar.

Nasıl çalışır

Bir HTTP isteği yaparsınız, Finexly API'den en güncel mid-market kurlarını içeren bir JSON alırsınız. Yıllar öncesine kadar herhangi bir tarih için tarihsel kurları, grafikler için time-series aralıklarını veya çarpmayı sizin için yapan doğrudan bir conversion endpoint'ini de getirebilirsiniz.

170+ para birimi için güncel kuru döndüren tek bir çağrı:

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

Yanıt, edge konumlarından 50 milisaniyenin altında gelir ve cache'lenebilir; yüksek trafikli fiyat sayfaları için kritik.

Kapsam ve fiyat

İyi bir döviz API'si genelde majör, minör, egzotik ve sıkça kripto dahil 170+ para birimini kapsar. Fiyatlandırma istek bazlıdır ve genellikle ödeme işlemcilerinin FX ücretlerinden çok daha ucuzdur. Finexly'nin ücretsiz planı ayda 1.000 ücretsiz istek içerir; küçük bir SaaS ürünü tamamen ücretsiz katmanda çalıştırılabilir. Daha yüksek hacimler için fiyat planları.

Önemli nokta: veri erişimi için ödeme yaparsınız, dönüştürülen değer için değil. Pazarlama sitenizde günde bir milyon dönüşüm gösteriyorsanız, hayali 1M USD'nin yüzdesini değil, CDN'de cache'lenmiş bir API çağrısının bedelini ödersiniz.

Güçlü olduğu yer

Kur verisi ödeme yüzeyi değil ürün yüzeyi olduğunda özel döviz API doğru araçtır. Örnekler: ziyaretçi locale'ine göre "19 €'dan itibaren" diyen pazarlama fiyat sayfası; kullanıcı yerel para biriminde bakiye gösteren SaaS dashboard; checkout öncesi 30 para birimine ön izleme yapan Shopify teması; USD faturayı tarihsel mid-market'le EUR defterine işleyen muhasebe; son 5 yılın EUR/USD trendini görselleştiren fintech uygulaması.

Bu yöne dair daha fazla için çoklu para birimli Shopify checkout ve React döviz çevirici kılavuzlarımıza bakın.

Zayıf olduğu yer

Özel bir döviz API mid-market referans kuru yayınlar. Bu, görüntüleme, muhasebe ve analiz için doğru sayıdır, ancak ödeme işlemcinizin bir kart işlemini mutabakatlamak için kullanacağı kur olmak zorunda değildir. Paranın gerçekte hareket edeceği tam kura ihtiyacınız varsa, işlemcinin quote'u doğrunun kaynağıdır. Mid-market piyasanın doğrusudur; işlemcinin kuru işlemin doğrusudur.

Yan yana karşılaştırma

Beş gerçek senaryo — hangisini seçmeli

1. Yerel para birimini gösteren fiyat sayfası

Bir SaaS işletiyorsunuz. Fiyat sayfası ABD ziyaretçilerine "$29/ay", Almanlara "27 €/ay" demeli. Özel döviz API. Bu görüntüleme, ödeme değil. Saatlerce cache'lenebilen tek bir sub-50ms istek istersiniz; içine %2 gömülmüş istek başı ödeme quote'u değil.

2. Sınır ötesi kart checkout

Müşteriniz EUR ile öder ama siz USD ile mutabakat yaparsınız. Makbuzdaki tutar, Stripe'ın karttan çektiğiyle aynı olmalı. Stripe FX Quotes API. Sepet yüklenirken 5 dakikalık quote kilitleyin, PaymentIntent'a iliştirin; müşteri uyumsuzluk görmez.

3. Net-30 vadeli B2B faturalama

Bugün GBP cinsinden fatura kesiyorsunuz; müşteri 25 gün sonra USD ile öder. İkisini birden. Finexly çevirici ile GBP tutarı ve USD referansı gösterip bağlam verin. Müşteri ödeme tıkladığında o anda taze bir Stripe quote isteyin. Düzenleme anındaki referans kur ile ödeme anındaki mutabakat kuru farklı işlerdir.

4. Hazine dashboard'u ve FX risk izleme

Finans ekibi, 7 para biriminde nakit bakiyesini ve EUR/USD'nin 90 günlük tarihsel grafiğini gösteren Looker tarzı bir dashboard istiyor. Özel döviz API. Stripe FX Quotes tarihsel veri döndürmez, time-series sağlamaz ve analitik için tasarlanmamıştır. Bir döviz API'si gereken tarihsel endpoint'leri yerleşik sunar.

5. Çevrimdışı modlu mobil uygulama

Wi-Fi'ı kötü havalimanlarında turistler için döviz çeviren bir seyahat uygulaması yayınlıyorsunuz. Özel döviz API. Açılışta 170 kuru ~4 KB JSON olarak cache'leyip her şeyi çevrimdışı çevirebilirsiniz. Stripe'ın FX araçları çevrimdışı çalışmaz çünkü canlı bir quote'a bağlıdır. Daha fazlası için mobil için kur API kılavuzu.

Kod örnekleri

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,
});

Garantili bir kur, ödemeden önce EUR tutarını gösterme ve tam eşleşen mutabakat elde edersiniz. Karşılığında: Stripe'ın FX ücreti artı kilit penceresi için küçük bir prim.

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}`);

Bu, gösterdiğiniz, loglatadığınız veya analitikte kullandığınız kurdur. Bir işleme bağlanmazsınız; piyasayı okursunuz. Yanıtı bir saat cache'leyin, tek bir API çağrısı binlerce sayfa görüntülemeye hizmet eder. Daha fazla dil örneği için Node.js entegrasyon kılavuzu veya Python eğitimi.

Dikkat edilmesi gereken gizli maliyetler

İki yaklaşımı karşılaştırırken manşet rakamlarda durmayın. Bazı maliyetler yüzeyin altında saklanır.

Stripe tarafında sürprizler. %2 FX ortalamadır; bazı koridorlar daha yüksek. Adaptive Pricing müşteriye görünmeden %2–4 dönüşüm ücreti ekleyerek efektif fiyatı artırabilir. Sınır ötesi kart ücretleri FX'in üzerine binebilir. Ayda 100K USD sınır ötesi işliyorsanız, %0,5 fark bile yılda 6K USD eder.

Döviz API tuzakları. Ücretsiz katmanlar genellikle agresif şekilde rate-limit uygular; ilk günden cache planlayın. Bazı sağlayıcılar yalnızca günlük günceller; gün içi hassasiyet gerekiyorsa frekansı doğrulayın. Üretime geçmeden önce cache ve hata yönetimi derinlemesine yazımızı okuyun.

Quote kullanmamanın maliyeti. Dünkü kurla fiyat gösterip Stripe bugünkü kurla mutabakat yaparsa, fark sizin kaybınız. %1'lik bir hareket işlem başına küçük olsa da bir ay boyunca birikir. Ya checkout'ta kilitleyin ya varyansı kabul edip fiyata tampon ekleyin.

En iyi sonuçlar için ikisini nasıl birleştirmeli

Finexly'de gördüğümüz en güçlü üretim mimarisi şöyle:

Bir özel döviz API, ödeme anının dışındaki her şeyi besler: fiyat sayfaları, dashboard'lar, muhasebe defterleri, mobil uygulamalar, arama, analitik, FX risk raporları. Agresif cache (1 saatlik TTL çoğu zaman yeterli). Tek API anahtarı, öngörülebilir maliyet, sub-50ms yanıt.

Stripe FX Quotes API, ödeme anının içindeki her şeyi besler: checkout'ta kilitli kurlar, makbuzlardaki tam rakamlar, mutabakatla uyumlu muhasebe kayıtları. Müşteri için sürpriz yok.

Mutabakat döngüyü kapatır. Bir Stripe mutabakatından sonra hem Stripe mutabakat kurunu hem de döviz API'sinin karşılık gelen mid-market'ini loglayın. Fark, gerçek FX maliyetinizdir ve zaman içinde takibi, bir fintech finans ekibinin yapabileceği en yüksek kaldıraçlı şeylerden biridir. Daha derin için döviz hedge'i ve döviz risk yönetimi kılavuzlarımızı okuyun.

Diğer özel sağlayıcılarla doğrudan karşılaştırma için ExchangeRate-API vs CurrencyLayer vs Finexly karşılaştırması aynı boyutlarda parçalara ayırır.

Sıkça sorulan sorular

Stripe FX Quotes API ücretsiz mi?

API'nin kendisi çağrı başına ücret almaz, ancak desteklediği dönüşümler Stripe'ın standart FX ücretini (çoğu çiftte ~%2) ve uzun kilitler için küçük bir primi içerir. Ayrı bir "abonelik" yoktur; fiyat ödemenin içine dahildir.

Stripe ödemelerini özel bir kurla mutabakatlamak için döviz API kullanabilir miyim?

Hayır. Stripe her zaman kendi kuruyla mutabakat yapar; harici bir kuru mutabakat motoruna enjekte edemezsiniz. Yapabileceğiniz şey, müşteriye özel bir kur göstermek (kendi API'nizden + kendi marjınızdan hesaplanan) ve sonra Stripe quote'u ile gerçek mutabakatı kilitlemektir. Ufak bir farkla bile şaşarsanız, açık sizin sırtınızda.

Özel döviz API ne kadar daha hızlı?

Edge'den tipik bir döviz API çağrısı 50 ms'nin altında döner. Stripe FX Quote round-trip genellikle 150–400 ms'dir çünkü Stripe ödeme altyapısına karşı imzalı canlı bir çağrıdır. Sayfa başına yüzlerce para birimi etiketi olan bir pazarlama sitesinde bu fark, anında render ile gözle görülür gecikme arasındaki farktır.

Bir Stripe quote kullanılmadan süresi dolarsa ne olur?

Geçersiz hale gelir ve yenisini istemeniz gerekir. Eşzamanlı checkout'ta nadirdir. Asenkron işlerde (B2B fatura, planlı transfer) baştan daha uzun bir süre seçin veya yenileyip müşteriyle yeniden teyit edin.

Stripe'ın FX ücretinden tamamen kaçınılabilir mi?

Bazen. Müşteri para biriminde bakiye tutar ve aynı para biriminde mutabakat yaparsanız FX gerekmez. Çoklu para birimli Stripe hesapları ve birden çok PSP'ye yayılmış bir hazine stratejisi büyük kısmı ortadan kaldırabilir. Bu stratejinin değip değmediğini modellemek için özel bir döviz API kullanırsınız.

Başlayın

Projenize gerçek zamanlı döviz kurları eklemeye hazır mısınız? Ücretsiz Finexly API anahtarınızı alın — kredi kartı gerekmez. Ayda 1.000 ücretsiz istek, sub-50ms yanıt ve 170+ para birimi ile başlayın, büyüdükçe ölçekleyin.