Zonos obsługuje pobieranie aktualnych kursów wymiany między dwiema walutami za pośrednictwem naszego interfejsu API GraphQL. Gwarantujemy kursy wymiany, które obliczamy między walutami. Chociaż aktualizujemy nasze kursy co 10 minut, gwarantujemy kurs z chwili jego pobrania przez 90 dni.
Zonos gwarantuje kursy wymiany tylko w przypadkach, gdy zajmujemy się płatnościami międzynarodowymi, na przykład za pośrednictwem Zonos Checkout lub niestandardowych integracji z naszym interfejsem API Zonos Payments. Aby uzyskać pełne szczegóły na temat sposobu gwarancji kursów wymiany, zapoznaj się z naszymi Warunkami usługi.
Tworzenie nowego obiektu kursu wymiany
Aby pobrać świeży kurs wymiany między dwiema walutami, możesz użyć mutacji createExchangeRate za pośrednictwem naszego interfejsu API GraphQL. Mutacja createExchangeRate obsługuje kod waluty source i target, a także typ kursu. Pełna dokumentacja dotycząca mutacji createExchangeRate znajduje się w naszym interfejsie API GraphQL. Kursy wymiany pobrane za pośrednictwem naszego interfejsu API są specyficzne dla organizacji.
Możesz użyć zapytania exchangeRate z podanym ID w celu pobrania wcześniej pobranych szczegółów kursu wymiany. Jest to przydatne, jeśli chcesz zobaczyć historyczne szczegóły kursu wymiany, użyć ich do raportów, interfejsów użytkownika itp. Pełną listę dostępnych pól można znaleźć w interfejsie API GraphQL.
Wcześniej utworzone kursy nie są odświeżane podczas pobierania, są one zafiksowane w czasie do ich pierwotnego pobrania.
Jeśli użyjesz Google do kursów wymiany, otrzymasz inną wartość niż ta, którą zapewnia nasz interfejs API. Kurs wymiany, na który patrzy Twój klient online, nie jest kursem dla konsumentów. Jeśli wyszukasz bieżący kurs przeliczenia USD na GBP w Google, zobaczysz „benchmark” kurs wymiany. To jest kurs, po którym duże międzynarodowe banki wymieniają setki milionów dolarów, ale nikt nie może kupować po tym kursie. Konsument zobaczy ten benchmark kurs plus opłaty pobierane przez firmę wymiany walut, gdy nie są używane kursy wymiany Zonos.
Inne witryny, które widzisz, najprawdopodobniej wyświetlają kurs wymiany dla wygody, ale nie pobierają faktycznie od klienta w jego obcej walucie. Firmy obsługujące karty kredytowe i banki wydające kartę będą pobierać opłaty za wymianę walut i opłaty za transakcje zagraniczne od klientów, którzy kupują na witrynach pobierających w USD. Chociaż wyświetlają walutę w GBP (lub innej walucie), kwota wyświetlana im przy kasie nie jest kwotą, którą ostatecznie zapłaci klient.
Jak wspomniano wcześniej, oferujemy gwarantowany kurs wymiany. Dodatkowe opłaty, które pobieramy, odpowiadają za stale wahający się rynek wymiany walut. W ciągu 90-dniowego gwarantowanego okresu dla pierwotnie pobranego kursu mogą następować zmiany. Dodatkowe opłaty zapewniają, że kwota wyświetlana i zapłacona przez klienta przy kasie stanowi całkowity i ostateczny koszt, który zapłaci — bez ukrytych lub zaskakujących opłat później.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Pobieranie kursu wymiany
Pobieranie kursów wymiany
Dowiedz się, jak pobrać kurs wymiany.Zonos obsługuje pobieranie aktualnych kursów wymiany między dwiema walutami za pośrednictwem naszego interfejsu API GraphQL. Gwarantujemy kursy wymiany, które obliczamy między walutami. Chociaż aktualizujemy nasze kursy co 10 minut, gwarantujemy kurs z chwili jego pobrania przez 90 dni.
Zonos gwarantuje kursy wymiany tylko w przypadkach, gdy zajmujemy się płatnościami międzynarodowymi, na przykład za pośrednictwem Zonos Checkout lub niestandardowych integracji z naszym interfejsem API Zonos Payments. Aby uzyskać pełne szczegóły na temat sposobu gwarancji kursów wymiany, zapoznaj się z naszymi Warunkami usługi.
Tworzenie nowego obiektu kursu wymiany
Aby pobrać świeży kurs wymiany między dwiema walutami, możesz użyć mutacji
createExchangeRateza pośrednictwem naszego interfejsu API GraphQL. MutacjacreateExchangeRateobsługuje kod walutysourceitarget, a także typ kursu. Pełna dokumentacja dotycząca mutacjicreateExchangeRateznajduje się w naszym interfejsie API GraphQL. Kursy wymiany pobrane za pośrednictwem naszego interfejsu API są specyficzne dla organizacji.mutation ExchangeRateCreate($input: ExchangeRateCreateInput!) {exchangeRateCreate(input: $input) {idratesourceCurrencyCodetargetCurrencyCode}}Pobieranie istniejącego kursu wymiany
Możesz użyć zapytania
exchangeRatez podanymIDw celu pobrania wcześniej pobranych szczegółów kursu wymiany. Jest to przydatne, jeśli chcesz zobaczyć historyczne szczegóły kursu wymiany, użyć ich do raportów, interfejsów użytkownika itp. Pełną listę dostępnych pól można znaleźć w interfejsie API GraphQL.Wcześniej utworzone kursy nie są odświeżane podczas pobierania, są one zafiksowane w czasie do ich pierwotnego pobrania.
query ExchangeRate($id: ID!) {exchangeRate(id: $id) {idratesourceCurrencyCodetargetCurrencyCodetargetFormat {decimalDelimitersymbolthousandsDelimiter}}}Kursy wymiany Google a kursy wymiany Zonos
Jeśli użyjesz Google do kursów wymiany, otrzymasz inną wartość niż ta, którą zapewnia nasz interfejs API. Kurs wymiany, na który patrzy Twój klient online, nie jest kursem dla konsumentów. Jeśli wyszukasz bieżący kurs przeliczenia USD na GBP w Google, zobaczysz „benchmark” kurs wymiany. To jest kurs, po którym duże międzynarodowe banki wymieniają setki milionów dolarów, ale nikt nie może kupować po tym kursie. Konsument zobaczy ten benchmark kurs plus opłaty pobierane przez firmę wymiany walut, gdy nie są używane kursy wymiany Zonos.
Inne witryny, które widzisz, najprawdopodobniej wyświetlają kurs wymiany dla wygody, ale nie pobierają faktycznie od klienta w jego obcej walucie. Firmy obsługujące karty kredytowe i banki wydające kartę będą pobierać opłaty za wymianę walut i opłaty za transakcje zagraniczne od klientów, którzy kupują na witrynach pobierających w USD. Chociaż wyświetlają walutę w GBP (lub innej walucie), kwota wyświetlana im przy kasie nie jest kwotą, którą ostatecznie zapłaci klient.
Jak wspomniano wcześniej, oferujemy gwarantowany kurs wymiany. Dodatkowe opłaty, które pobieramy, odpowiadają za stale wahający się rynek wymiany walut. W ciągu 90-dniowego gwarantowanego okresu dla pierwotnie pobranego kursu mogą następować zmiany. Dodatkowe opłaty zapewniają, że kwota wyświetlana i zapłacona przez klienta przy kasie stanowi całkowity i ostateczny koszt, który zapłaci — bez ukrytych lub zaskakujących opłat później.
ExchangeRateCreateInput
exchangeRateCreate
Czy ta strona była pomocna?