DOCS

Retrieve an exchange rate

/

Hent valutakurser

Lær hvordan du henter en valutakurs rate.

Zonos understøtter hentning af opdaterede valutakurser mellem to valutaer gennem vores GraphQL API. Vi garanterer de valutakurser, vi beregner mellem valutaer. Selvom vi opdaterer vores kurser hvert 10. minut, garanterer vi rate fra det tidspunkt, det blev hentet i 90 dage.

Zonos garanterer kun valutakurser for tilfælde, hvor vi håndterer internationale betalinger, såsom gennem Zonos Checkout eller tilpassede integrationer med vores Zonos Payments API. For fulde specifikationer om, hvordan vi garanterer valutakurser, se vores Vilkår for service.

Opret et nyt valutakurs rate objekt

For at hente en ny valutakurs rate mellem to valutaer, kan du bruge createExchangeRate mutation via vores GraphQL API. createExchangeRate understøtter en source og target valuta kode, samt en rate type. Fuld dokumentation omkring createExchangeRate mutation kan findes i vores GraphQL API reference. Valutakurser hentet med vores API er organisationsspecifikke.

Mutation

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 bruge exchangeRate forespørgslen med et angivet ID til at hente tidligere hentede valutakurs rate detaljer. Dette er nyttigt, hvis du vil se historiske valutakurs rate detaljer, bruge dem til rapporter, brugergrænseflader osv. Du kan se en fuld liste over tilgængelige felter i GraphQL API-referencen.

Tidligere oprettede kurser opdateres ikke, når du henter dem; de er fastlåst i tid til det tidspunkt, de oprindeligt blev hentet.

Mutation

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 bruger Google til valutakurser, vil du få en anden værdi end den, vores API leverer. Den valutakurs rate, som din kunde ser online, er ikke en forbrugerkurs rate. Hvis du Googler den aktuelle USD til GBP konverteringskurs rate, vil du se den "benchmark" valutakurs rate. Dette er kursen rate, hvortil store internationale banker udveksler hundredvis af millioner af dollars, men ingen kan købe til denne kurs rate. En forbruger vil se denne benchmark kurs rate plus gebyrer opkrævet af valutavekslingsfirmaet, når Zonos valutakurser ikke anvendes.

De andre sider, du ser, viser sandsynligvis valutakursen rate for bekvemmelighedens skyld, men de opkræver faktisk ikke kunden i deres udenlandske valuta. Kreditkortselskaber og banker, der udsteder kortet, vil opkræve valutavekslings- og udenlandske transaktionsgebyrer til kunder, der køber fra sider, der opkræver i USD. Selvom de viser valutaen i GBP (eller enhver anden valuta), er det beløb, der vises for dem ved checkout, ikke det beløb, kunden i sidste ende vil betale.

Som nævnt tidligere tilbyder vi en garanteret valutakurs rate. De ekstra gebyrer, vi opkræver, tager højde for det konstant svingende valutamarked. Variationer er sandsynlige at finde sted over den 90-dages garanterede periode for den oprindeligt hentede kurs rate. De ekstra gebyrer sikrer, at det beløb, der vises og betales af kunden ved checkout, er den totale og endelige omkostning, de vil betale—ingen skjulte eller overraskende gebyrer senere.

Var denne side nyttig?