DOCS

Retrieve an exchange rate

/

Haal wisselkoersen op

Leer hoe je een wisselkoers rate kunt ophalen.

Zonos ondersteunt het ophalen van actuele wisselkoersen tussen twee valuta's via onze GraphQL API. We garanderen de wisselkoersen die we berekenen tussen valuta's. Hoewel we onze tarieven elke 10 minuten bijwerken, garanderen we de rate vanaf het moment dat deze is opgehaald voor 90 dagen.

Zonos garandeert alleen wisselkoersen voor gevallen waarin we internationale betalingen verwerken, zoals via Zonos Checkout of aangepaste integraties met onze Zonos Payments API. Voor volledige details over hoe we wisselkoersen garanderen, raadpleeg onze Algemene Voorwaarden.

Maak een nieuw wisselkoers rate object

Om een nieuwe wisselkoers rate tussen twee valuta's op te halen, kun je de createExchangeRate mutatie gebruiken via onze GraphQL API. createExchangeRate ondersteunt een source en target valutacode, evenals een rate type. Volledige documentatie over de createExchangeRate mutatie is te vinden in onze GraphQL API referentie. Wisselkoersen die met onze API zijn opgehaald, zijn specifiek voor de organisatie.

Mutatie

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

Antwoord

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

Haal een bestaande wisselkoers rate op

U kunt de exchangeRate query gebruiken met een opgegeven ID om eerder opgehaalde wisselkoers rate details op te halen. Dit is nuttig als u historische wisselkoers rate details wilt bekijken, deze wilt gebruiken voor rapporten, gebruikersinterfaces, enz. U kunt een volledige lijst van beschikbare velden zien op de GraphQL API-referentie.

Eerder gemaakte tarieven worden niet vernieuwd wanneer u ze ophaalt; ze zijn vastgelegd in de tijd van wanneer ze oorspronkelijk zijn opgehaald.

Mutatie

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

Antwoord

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

Wanneer je Google gebruikt voor wisselkoersen, krijg je een andere waarde dan wat onze API biedt. De wissel rate waar je klant online naar kijkt, is geen consumenten rate. Als je de huidige USD naar GBP conversie rate op Google zoekt, wat je zult zien is de “benchmark” buitenlandse wissel rate. Dit is de rate waar grote internationale banken honderden miljoenen dollars mee wisselen, maar niemand kan kopen tegen deze rate. Een consument zal deze benchmark rate plus kosten zien die door het buitenlandse wisselbedrijf in rekening worden gebracht wanneer Zonos wisselkoersen niet worden gebruikt.

De andere sites die je ziet, tonen waarschijnlijk de wissel rate voor het gemak, maar ze brengen de klant eigenlijk niet in rekening in hun buitenlandse valuta. Creditcardmaatschappijen en banken die de kaart uitgeven, zullen buitenlandse wissel- en buitenlandse transactie kosten in rekening brengen aan klanten die kopen van sites die in USD rekenen. Zelfs als ze de valuta in GBP (of een andere valuta) tonen, is het bedrag dat hen wordt getoond bij checkout niet het bedrag dat de klant uiteindelijk zal betalen.

Zoals eerder vermeld, bieden wij een gegarandeerde wissel rate. De extra kosten die wij in rekening brengen, houden rekening met de voortdurend fluctuërende wisselmarkt. Variaties zullen waarschijnlijk optreden gedurende de 90-dagen garantieperiode voor de oorspronkelijk opgehaalde rate. De extra kosten zorgen ervoor dat het bedrag dat wordt weergegeven en betaald door de klant bij checkout de totale en definitieve kosten zijn die ze zullen betalen—geen verborgen of verrassingskosten later.

Was deze pagina nuttig?