DOCS

Retrieve an exchange rate

/

Döviz kurlarını al

Bir döviz rate almayı öğrenin.

Zonos, iki para birimi arasındaki güncel döviz kurlarını GraphQL API'miz aracılığıyla almayı destekler. Hesapladığımız döviz kurlarını garanti ediyoruz. Kurlarımızı her 10 dakikada bir güncelliyoruz, ancak alındığı andan itibaren 90 gün boyunca rate garantisi veriyoruz.

Zonos yalnızca uluslararası ödemeleri yönettiğimiz durumlar için döviz kurlarını garanti eder; örneğin, Zonos Checkout veya Zonos Ödeme API'mizle özel entegrasyonlar aracılığıyla. Döviz kurlarını nasıl garanti ettiğimiz hakkında tam ayrıntılar için Hizmet Şartlarımızı inceleyin.

Yeni bir döviz rate nesnesi oluştur

İki para birimi arasında yeni bir döviz rate almak için, GraphQL API'miz aracılığıyla createExchangeRate mutasyonunu kullanabilirsiniz. createExchangeRate, bir source ve target para birimi kodu ile birlikte bir rate türünü destekler. createExchangeRate mutasyonu hakkında tam belgeler GraphQL API referansımızda bulunabilir. API'mizle alınan döviz kurları organizasyona özeldir.

Mutasyon

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation {
  exchangeRateCreate(
    input: {
      sourceCurrencyCode: GBP
      targetCurrencyCode: EUR
      type: MID_MARKET
    }
  ) {
    id
    rate
    sourceCurrencyCode
    targetCurrencyCode
  }
}

Yanıt

1
2
3
4
5
6
7
8
9
10
{
  "data": {
    "createExchangeRate": {
      "id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
      "rate": 0.6391,
      "sourceCurrencyCode": "GBP",
      "targetCurrencyCode": "EUR"
    }
  }
}

Mevcut bir döviz rate'ini al

Daha önce alınmış döviz rate detaylarını almak için sağlanan ID ile exchangeRate sorgusunu kullanabilirsiniz. Bu, tarihsel döviz rate detaylarını görmek, raporlar, kullanıcı arayüzleri vb. için kullanmak istediğinizde faydalıdır. Mevcut alanların tam listesini GraphQL API referansı üzerinde görebilirsiniz.

Daha önce oluşturulmuş oranlar, alındıklarında zamanla sabitlenir ve yenilenmez.

Mutation

1
2
3
4
5
query {
  exchangeRate(id: "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616") {
    // Field names here...
  }
}

Yanıt

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "data": {
    "exchangeRate": {
      "id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
      "rate": 0.6391,
      "sourceCurrencyCode": "CAD",
      "targetCurrencyCode": "GBP",
      "targetFormat": {
        "decimalDelimiter": ".",
        "symbol": "£",
        "thousandsDelimiter": ","
      }
    }
  }
}

Google döviz kurları vs Zonos döviz kurları 

Google'ı döviz kurları için kullandığınızda, API'mizin sağladığı değerden farklı bir değer alırsınız. Müşterinizin çevrimiçi olarak baktığı döviz rate bir tüketici rate değildir. Mevcut USD'den GBP'ye dönüşüm rate için Google araması yaptığınızda, göreceğiniz şey “ölçüt” döviz rate olacaktır. Bu, büyük uluslararası bankaların yüz milyonlarca doları değiştirdiği ratedur, ancak hiç kimse bu rate üzerinden satın alamaz. Bir tüketici, bu ölçüt rate ile birlikte, Zonos döviz kurları kullanılmadığında döviz şirketinin aldığı ücretleri görecektir.

Gördüğünüz diğer siteler muhtemelen döviz ratenu kolaylık sağlamak amacıyla göstermektedir, ancak aslında müşteriyi kendi dövizinde ücretlendirmemektedirler. Kredi kartı şirketleri ve kartı veren bankalar, USD cinsinden ücretlendiren sitelerden alışveriş yapan müşterilerden döviz ve yabancı işlem ücretleri alacaktır. GBP (veya başka bir para birimi) cinsinden gösterilse bile, checkout aşamasında onlara gösterilen miktar, müşterinin nihayetinde ödeyeceği miktar değildir.

Daha önce belirtildiği gibi, garanti edilen bir döviz rate sunuyoruz. Aldığımız ek ücretler, sürekli dalgalanan döviz piyasasını hesaba katmaktadır. İlk alınan rate için 90 günlük garanti süresi boyunca değişiklikler olasıdır. Ek ücretler, müşterinin checkout aşamasında görünen ve ödenen miktarın, ödeyecekleri toplam ve nihai maliyet olduğunu garanti eder—sonradan gizli veya sürpriz ücretler yoktur.

Bu sayfa yardımcı oldu mu?