DOCS

Retrieve an exchange rate

/

Pobierz kursy wymiany

Dowiedz się, jak pobrać kurs wymiany rate.

Zonos wspiera pobieranie aktualnych kursów wymiany między dwiema walutami za pośrednictwem naszego GraphQL API. Gwarantujemy kursy wymiany, które obliczamy między walutami. Chociaż aktualizujemy nasze kursy co 10 minut, gwarantujemy rate od momentu jego pobrania przez 90 dni.

Zonos gwarantuje kursy wymiany tylko w przypadkach, gdy obsługujemy płatności międzynarodowe, takie jak przez Zonos Checkout lub niestandardowe integracje z naszym Zonos Payments API. Aby uzyskać pełne szczegóły dotyczące tego, jak gwarantujemy kursy wymiany, zapoznaj się z naszymi Warunkami korzystania z usługi.

Utwórz nowy obiekt kursu wymiany rate

Aby pobrać świeży kurs wymiany rate między dwiema walutami, możesz użyć mutacji createExchangeRate za pośrednictwem naszego GraphQL API. createExchangeRate obsługuje kod waluty source i target, a także typ rate. Pełna dokumentacja dotycząca mutacji createExchangeRate znajduje się w naszej referencji API GraphQL. Kursy wymiany pobrane za pomocą naszego API są specyficzne dla organizacji.

Mutacja

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
  }
}

Odpowiedź

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"
    }
  }
}

Pobierz istniejący kurs wymiany rate

Możesz użyć zapytania exchangeRate z podanym ID, aby pobrać szczegóły wcześniej pobranego kursu wymiany rate. Jest to przydatne, jeśli chcesz zobaczyć historyczne szczegóły kursu wymiany rate, użyć ich do raportów, interfejsów użytkownika itp. Pełną listę dostępnych pól możesz zobaczyć w odniesieniu do API GraphQL.

Wcześniej utworzone kursy nie są odświeżane, gdy je pobierasz, są przypięte w czasie do momentu, w którym zostały pierwotnie pobrane.

Mutacja

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

Odpowiedź

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": ","
      }
    }
  }
}

Kursy wymiany Google a kursy wymiany Zonos 

Kiedy używasz Google do sprawdzania kursów wymiany, otrzymasz inną wartość niż ta, którą podaje nasze API. Kurs wymiany rate, na który patrzy Twój klient w Internecie, nie jest kursem wymiany dla konsumentów rate. Jeśli wpiszesz w Google aktualny kurs wymiany USD na GBP rate, to co zobaczysz to „benchmarkowy” kurs wymiany rate. Jest to rate, po którym duże międzynarodowe banki wymieniają setki milionów dolarów, ale nikt nie może kupić po tym rate. Konsument zobaczy ten benchmarkowy rate plus opłaty pobierane przez firmę zajmującą się wymianą walut, gdy kursy wymiany Zonos nie są używane.

Inne strony, które widzisz, najprawdopodobniej wyświetlają kurs wymiany rate dla wygody, ale tak naprawdę nie obciążają klienta w ich walucie obcej. Firmy wydające karty kredytowe i banki, które wydają karty, będą pobierać opłaty za wymianę walut i opłaty za transakcje zagraniczne od klientów, którzy kupują na stronach, które pobierają w USD. Mimo że wyświetlają walutę w GBP (lub innej walucie), kwota wyświetlana im przy checkout nie jest kwotą, którą klient ostatecznie zapłaci.

Jak już wcześniej wspomniano, oferujemy gwarantowany kurs wymiany rate. Dodatkowe opłaty, które pobieramy, uwzględniają stale zmieniający się rynek wymiany. Wahania mogą wystąpić w ciągu 90-dniowego okresu gwarancji dla pierwotnie pobranego rate. Dodatkowe opłaty zapewniają, że kwota wyświetlana i płacona przez klienta przy checkout jest całkowitym i ostatecznym kosztem, który zapłaci—bez ukrytych lub niespodziewanych opłat później.

Czy ta strona była pomocna?