DOCS

Retrieve an exchange rate

/

Hent valutakurser

Lær hvordan du henter en valutakurs rate.

Zonos støtter henting av oppdaterte valutakurser mellom to valutaer gjennom vår GraphQL API. Vi garanterer valutakursene vi beregner mellom valutaer. Selv om vi oppdaterer våre kurser hvert 10. minutt, garanterer vi rate fra det tidspunktet det ble hentet i 90 dager.

Zonos garanterer kun valutakurser for tilfeller der vi håndterer internasjonale betalinger, som gjennom Zonos Checkout eller tilpassede integrasjoner med vår Zonos Payments API. For full spesifikasjon om hvordan vi garanterer valutakurser, se våre Vilkår for bruk.

Opprett et nytt valutakurs rate objekt

For å hente en fersk valutakurs rate mellom to valutaer, kan du bruke createExchangeRate mutasjonen via vår GraphQL API. createExchangeRate støtter en source og target valutakode, samt en rate type. Full dokumentasjon rundt createExchangeRate mutasjonen kan finnes i vår GraphQL API referanse. Valutakurser hentet med vår API er organisasjonsspesifikke.

Mutasjon

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

Svar

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

Hent en eksisterende valutakurs rate

Du kan bruke exchangeRate-forespørselen med en gitt ID for å hente tidligere hentede valutakurs rate detaljer. Dette er nyttig hvis du ønsker å se historiske valutakurs rate detaljer, bruke dem til rapporter, brukergrensesnitt osv. Du kan se en fullstendig liste over tilgjengelige felt i GraphQL API-referansen.

Tidligere opprettede kurser blir ikke oppdatert når du henter dem, de er fastlåst i tid til når de opprinnelig ble hentet.

Mutasjon

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

Svar

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 valutakurser vs Zonos valutakurser 

Når du bruker Google for valutakurser, vil du få en annen verdi enn det vår API gir. Valutakursen rate kunden din ser på nettet er ikke en forbruker rate. Hvis du søker på den nåværende USD til GBP konverteringskursen rate på Google, vil du se "benchmark" valutakursen rate. Dette er kursen rate som store internasjonale banker bruker for å utveksle hundrevis av millioner dollar, men ingen kan kjøpe til denne kursen rate. En forbruker vil se denne benchmark-kursen rate pluss gebyrer som belastes av valutafirmaet når Zonos valutakurser ikke brukes.

De andre nettstedene du ser viser mest sannsynlig valutakursen rate for enkelhets skyld, men de belaster faktisk ikke kunden i deres utenlandske valuta. Kredittkortselskaper og banker som utsteder kortet vil belaste utenlandske valutagebyrer og utenlandske transaksjonsgebyrer til kunder som kjøper fra nettsteder som belaster i USD. Selv om de viser valutaen i GBP (eller en annen valuta), er beløpet som vises til dem ved checkout ikke det beløpet kunden til slutt vil betale.

Som nevnt tidligere, tilbyr vi en garantert valutakurs rate. De ekstra gebyrene vi belaster tar hensyn til det stadig skiftende valutamarkedet. Variasjoner vil sannsynligvis finne sted over den 90-dagers garantiperioden for den opprinnelig hentede kursen rate. De ekstra gebyrene sikrer at beløpet som vises og betales av kunden ved checkout er den totale og endelige kostnaden de vil betale—ingen skjulte eller overraskende gebyrer senere.

Var denne siden nyttig?